grill-with-docs
Entrevista decisões arquiteturais por work item isolado, mantém feature plan-only e oferece hotfix-fast executável com HOTFIX-GO fail-closed.
- License 许可
- MIT
- 最近更新
- 2026-09-28
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- grill-with-docs
- description
- Entrevista decisões arquiteturais por work item isolado, mantém feature plan-only e oferece hotfix-fast executável com HOTFIX-GO fail-closed.
- argument-hint
- iniciar|retomar|pausar|auditar|conciliar|migrar|status|checkpoint <git-root>
02 资源文件 68
- 资产文件assets/ADR.template.md945 B
- 资产文件assets/agent-orchestration.v1.json4.1 KB
- 资产文件assets/agent-orchestration.v2.json5.5 KB
- 资产文件assets/AUDIT.template.md569 B
- 资产文件assets/claude-code-local-skills.catalog.json5.9 KB
- 资产文件assets/codex-v4-local-skills.catalog.json6.3 KB
- 资产文件assets/codex-v5-local-skills.catalog.json6.3 KB
- 资产文件assets/CONSTITUTION-CHECK.template.md592 B
- 资产文件assets/CONTEXT.template.md285 B
- 资产文件assets/DECISION-BACKLOG.template.md362 B
- 资产文件assets/DECISION-FRONTIER.template.md391 B
- 资产文件assets/DELIVERY-MAP.template.md640 B
- 资产文件assets/dependencies.json6.8 KB
- 资产文件assets/GOAL.template.md15.4 KB
- 资产文件assets/GRILL-CONSTITUTION.template.md1.5 KB
- 资产文件assets/grill-local-skills.manifest.json430 B
- 资产文件assets/grill-v4-local-skills.catalog.json6.4 KB
- 资产文件assets/grill-v5-local-skills.catalog.json6.4 KB
- 资产文件assets/jev-questions.json11.8 KB
- 资产文件assets/PHASE-SPECIFY-HANDOFF.template.md652 B
- 资产文件assets/PLAN-CONTEXT.template.md409 B
- 资产文件assets/ROADMAP.template.md1.0 KB
- 资产文件assets/ROUND-LOG.template.jsonl281 B
- 资产文件assets/state.template.json1.2 KB
- 资产文件assets/task-files.v1.template.md1.1 KB
- 资产文件assets/WORK-ITEM.template.json716 B
- 资产文件assets/workflow-step-skills.json8.7 KB
- 资产文件assets/workflow-step-skills.v4.json11.9 KB
- 资产文件assets/workflow-step-skills.v5.json11.9 KB
- 资产文件assets/workflow-tier-models.json1.1 KB
- 资产文件assets/workflow-trusted-catalogs.json202 B
- 资产文件assets/workflow-trusted-catalogs.v4.json303 B
- 资产文件assets/workflow-trusted-catalogs.v5.json303 B
- 资产文件assets/WORKFLOW.template.md3.8 KB
- 资产文件assets/WORKFLOW.v3.template.md8.3 KB
- 资产文件assets/WORKFLOW.v4.template.md10.0 KB
- 资产文件assets/WORKFLOW.v5.template.md10.2 KB
- 参考文档references/agent-orchestration.md3.8 KB
- 参考文档references/agent-orchestration.v2.md3.4 KB
- 参考文档references/session-operations.md34.1 KB
- 参考文档references/session-protocol.md9.3 KB
- 参考文档references/upstream-attribution.md415 B
- 参考文档references/work-item-operations.md35.4 KB
- 脚本scripts/audit_decisions.py47.1 KB
- 脚本scripts/backlog_bridge.py31.7 KB
- 脚本scripts/ensure_dependencies.py32.1 KB
- 脚本scripts/ensure_goal.py9.2 KB
- 脚本scripts/ensure_workflow.py22.7 KB
- 脚本scripts/grill_core/__init__.py81 B
- 脚本scripts/grill_core/agent_orchestration.py115.8 KB
- 脚本scripts/grill_core/agent_runtime.py88.7 KB
- 脚本scripts/grill_core/attestation.py66.4 KB
- 脚本scripts/grill_core/gauntlet_runs.py175.3 KB
- 脚本scripts/grill_core/gauntlet.py36.1 KB
- 脚本scripts/grill_core/goal_document.py3.7 KB
- 脚本scripts/grill_core/jev.py13.7 KB
- 脚本scripts/grill_core/partition.py28.3 KB
- 脚本scripts/grill_core/step_skills.py54.2 KB
- 脚本scripts/grill_core/store.py125.9 KB
- 脚本scripts/grill_core/tier_models.py10.3 KB
- 脚本scripts/grill_core/triage.py10.6 KB
- 脚本scripts/grill_core/work_item_v3.py50.4 KB
- 脚本scripts/grill_core/workflow_v3.py29.6 KB
- 脚本scripts/grill_core/workflow_v4.py12.9 KB
- 脚本scripts/grill_core/workflow_v5.py2.9 KB
- 脚本scripts/grill_core/workflow_versions.py11.4 KB
- 脚本scripts/grill_status.py22.4 KB
- 脚本scripts/grill_workspace.py481.8 KB
03 SKILL.md 正文
Grill with Docs v9.3.5
Protocolo plan-only para uma feature, fix ou hotfix em worktree/branch dedicada. Cada trabalho possui identidade e artefatos próprios; o estado global é somente uma projeção de trabalhos concluídos.
worktree A ──> .grill/work-items/<work-id-A>/ ─┐
worktree B ──> .grill/work-items/<work-id-B>/ ─┼─> reconcile ─> .grill/global/
worktree C ──> .grill/work-items/<work-id-C>/ ─┘
Regras invioláveis
- Nunca grave artefatos decisórios no root legado durante um trabalho novo.
- Nunca escreva no diretório de outro
work_id. WORKFLOW.mde.specify/memory/constitution.mdsão project-wide.- A Constituição é criada no-clobber somente pelo bootstrap
init; depois é read-only. Ausência no init é bootstrap pendente, nãonot-present. - Nenhum ADR, decisão local ou reconciliação pode dispensar, enfraquecer ou violar a Constituição.
- Hooks são read-only e nunca criam work items automaticamente.
- Hotfix-fast é uma exceção operacional fechada: exige escopo, reprodução/evidência, teste de correção, rollback e evidência constitucional; não depende de ROADMAP, BL, DQ ou reconciliação para ser seguro.
- Feature e fix permanecem plan-only; hotfix só entrega HOTFIX-GO para ship externo. Depois do ship,
hotfix-closeprova o commit na branch de integração e sela o fechamento; só então vêm a reconciliação e a auditoria documental completa. - A sessão de entrevista termina em
PLAN_ONLY_STOP; nela não se implementa código, não se executaspecify|plane não se faz commit/merge. O ciclo externo é outra trilha, aberta por ato humano.
Bootstrap de apresentação obrigatório
Em toda entrada GWD (iniciar, retomar, reentrada após compactação e sessão de especialista), aplique i-have-adhd@i-have-adhd como referência de apresentação local deste fluxo antes da primeira resposta de trabalho. Resolva a instalação efetiva do runtime, confirme habilitação e confiança por observações separadas, leia integralmente o SKILL.md aprovado indicado pelo load_request e registre o evento correlacionado à mesma sessão, configuração e escopo GWD. Não peça ao usuário para invocar a skill upstream, não execute seu hook e não crie flag/configuração global.
Instalado, enabled, saída zero, catálogo, hash impresso ou autorrelato não comprovam loaded nem comportamento. Só work_ready permite entrada ou despacho: normalmente exige use_ready; stop adhd mode documentado na mesma sessão/incarnation/escopo mantém apenas work_ready após compactação, com use_ready=false, sem reinjetar o corpo. Nova sessão, troca de runtime/incarnation e reativação explícita voltam ao padrão ativo e exigem nova leitura. Preserve Ponytail, instruções superiores, conteúdo solicitado, exceções upstream, arquivos/grants e o escopo local; saída do fluxo GWD é out_of_scope.
Orquestração por versão
A versão do work item seleciona o contrato: v3/v4 conservam a policy v1 e o
suplemento histórico; v5 usa
assets/agent-orchestration.v2.json e o suplemento v2.
Novos projetos materializam v5; projetos existentes conservam seu WORKFLOW.md.
Não migrar trabalho ativo implicitamente nem reinterpretar DAGs, catálogos ou receipts.
Leia o protocolo de sessão para admissão, capabilities,
cleanup, continuidade e recuperação. O líder invoca as onze skills canônicas na sessão
ativa e persiste seus retornos. Sol no Codex e Opus no Claude são recomendações,
não trocas automáticas. Autoria especializada continua xhigh; revisão independente high.
O coordenador Orca inicia o líder com worker-start, mantém seu próprio terminal aberto e, após o relatório final e worker_done aceito, executa worker-release com read-back do Dispatch. Pausa conserva a sessão. Workers e especialistas também encerram por settlement, release e read-back antes de declarar cleanup concluído; terminal close não substitui esse fluxo.
No v5, somente plan/review exigem revisão fixa; risco material exige revisão extra.
gauntlet-step-enter entrega a classificação e seu hash, atividades e suplementos exigidos.
Ausência de evidência bloqueia; entrega de contexto não atesta execução.
Antes de novo despacho, aproveite resultados aceitos via gauntlet-tasks-import ou
gauntlet-tasks-rebase, conforme o protocolo. Não repita trabalho aceito para resolver
cleanup pendente ou resultado desconhecido. PLAN_ONLY_STOP continua encerrando a entrevista.
Entrada e entrevista
Antes de iniciar trabalho, leia no protocolo de sessão o bootstrap, a seleção de policy e o contrato de entrevista da versão correspondente. Antes de executar cada operação, leia sua seção no manual de work items: triagem, init, dependências/backlog, Constituição, auditoria, atestação, reconciliação ou migração. O manual mantém os argumentos e recusas completos; não inferir flags nem emular handlers.
Para a entrevista, carregar Constituição, WORKFLOW, CONTEXT, ADRs, ROADMAP, DECISION-BACKLOG, PLAN-CONTEXT e handoff selecionado, somente do work item atual. Classificar cenário, registrar evidência e selecionar DQs materiais com dependências satisfeitas. V3/v4: uma pergunta atômica por rodada. V5: até três independentes; respostas parciais mantêm DQs sem resposta pendentes. Registrar transição por DQ, impact scan e log append-only. Duas rodadas sem progresso, três expansões consecutivas ou 25 perguntas materiais exigem checkpoint e SAFETY_STOP. Pausa humana grava PAUSED_USER; contradições são preservadas. Após auditoria GO e handoff, emitir PLAN_ONLY_STOP e parar; sem implementação ou ship.
Decisões tipadas via Jev
OPENROUTER_API_KEY é obrigatória: sem ela init e preflight recusam com
OPENROUTER-KEY-REQUIRED. Antes de decidir em prosa, rode
grill_workspace.py decide ROOT --kind K[,K2] --file ... [--context JSON] --work-id ID.
Kinds do mesmo momento vão numa chamada só (--kind triage,bug-type).
Use decided sem deliberar e responda só as pending (decided_by = jev|partial|agent).
Quando: step-assessment antes de cada etapa (--step --apply); round-record após cada
resposta de DQ; dq-batch e human-or-author ao montar o lote; triage, bug-type;
delivery-classification (context.proposed, divergência = pergunte ao humano);
constitution-check (só antecipa VIOLATION); partition-groups (só sugere o teto
--groups do partition-emit; o agrupamento segue determinístico em código); finding-severity
após analyze/converge/review (context.findings com proposed; só confirma ou sobe);
spec-coverage e diff-hygiene no verify (só NO-GO/sinalização); learning-route no ship.
Depois de decidir as pendentes, registre a resposta final com decide-label.
Entre etapas use advance (fecha a corrente, classifica e abre a seguinte); depois de
supersessão ou integração da main, attest --rechain recunha a cadeia stale de uma vez.
Falha de API é fail-closed (JEV-UNAVAILABLE, OPENROUTER-*): pare e reporte.
O Jev nunca substitui skill canônica nem review obrigatório.
Status humano canônico
Para status, execute python3 .../grill_workspace.py status ROOT --format markdown
e reproduza stdout literalmente, sem resumir, traduzir ou acrescentar explicações.
Status, hooks e diagnóstico são read-only. Falha de bootstrap permite diagnóstico,
nunca declarar apresentação funcional sem prova correlacionada.
04 同仓库更多 Skills
offline-presentation-fixture
暂无简介
grill-partition
Particiona tasks.md em subfases file-disjuntas e emite o Execution DAG versionado da etapa partition, de forma determinística e sem julgamento de modelo.
grill-implement-parallel
Orquestra os workers não-frontier da etapa implement-parallel sobre o Execution DAG, com worktree isolado por worker e receipt submetido apenas pelo leader.
speckit-verify-review-ship-verify
Run post-convergence executable gates and diff hygiene checks
speckit-verify-review-ship-v
Run post-convergence executable gates and diff hygiene checks
speckit-verify-review-ship-ship
Capture approved project learnings, revalidate, merge safely, clean up, and summarize delivery