chore: bootstrap do toolkit de agents (.claude/agents + .claude/skills) - #4
Open
naroga wants to merge 1 commit into
Open
chore: bootstrap do toolkit de agents (.claude/agents + .claude/skills)#4naroga wants to merge 1 commit into
naroga wants to merge 1 commit into
Conversation
Adiciona scaffolding mínimo para o fluxo de agents desta gem: - .claude/agents/backend-implementer.md — agent para mexer em lib/gmail/ e spec/gmail/, ciente de workers paralelos, com regras de commit explícito e proibição de fallbacks silenciosos. - .claude/skills/create-story/ — cria stories locais em .claude/stories/<id>.md via entrevista dinâmica. - .claude/skills/implement-feature/ — orquestra implementação em ondas, com sub-tasks isoladas por arquivo em .claude/stories/<parent>/sub-<n>.md. - .claude/skills/open-pull-request/ — abre PR em pt-BR contra master, push pra remote fork (naroga/gmail), sem reviewers nem labels automáticos. - .gitignore — exclui .claude/stories/ (tracking local por desenvolvedor, nunca comitado). Sem agents de frontend, database, infra ou docs-guardian (a gem é backend puro, sem DB, sem frontend, sem CI no master ainda, sem docs/). Os agents referenciam CLAUDE.md como TBD até a PR gmailgem#2 (chore/bootstrap-claude-config) mergear.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Contexto
Este PR introduz o scaffolding mínimo de agents e skills locais (
.claude/agents/+.claude/skills/) para padronizar o fluxo de desenvolvimento assistido nesta gem. É o terceiro de uma trinca de PRs de bootstrap:CLAUDE.md(convenções do projeto)docs/(documentação por módulo)Branch ancorada em
master(não empilhada sobre as outras três) para permitir review independente.Mudanças
.claude/agents/backend-implementer.md— único agent scaffoldado. Esta gem é backend Ruby puro (sem frontend, sem DB, sem CI nomasterainda, semdocs/), então os agentsfrontend-implementer,database-analyst,infrastructureedocs-guardianforam deliberadamente omitidos..claude/skills/create-story/— cria stories locais em.claude/stories/<id>.mdvia entrevista dinâmica. Não usa GitHub Issues nem nenhum tracker remoto..claude/skills/implement-feature/— orquestrador em ondas; sub-tasks vivem em.claude/stories/<parent>/sub-<n>.mdcom isolamento por arquivo..claude/skills/open-pull-request/— abre PR em pt-BR contramaster, push para a remotefork(naroga/gmail), sem labels nem reviewers automáticos..gitignore— adiciona.claude/stories/(tracking local por desenvolvedor, nunca comitado).Decisões
.claude/stories/(no.gitignore). Sem dependência de GitHub Issues, Trello, Linear ou MCPs externos..claude/stories/<parent>/sub-<n>.md.gh,git,rspec,rubocop.#<story-id> <type>(<scope>): <descrição>. Stage explícito por arquivo, nuncagit add .. Sem assinatura de IA.Dependências de outros PRs
Depende da PR #2 (
chore/bootstrap-claude-config) mergear: obackend-implementer.mdreferenciaCLAUDE.mdcomo fonte de verdade das convenções do projeto. Enquanto a PR #2 não mergeia, esses pontos estão marcados explicitamente como TBD no agent, com fallback paragemspec+.rubocop.yml+README.md.Não depende da PR #1 (quality-gates) nem da PR #3 (docs/) para funcionar, mas referencia ambas como TBDs onde aplicável (CI futuro,
docs/futuro).Como testar
ls .claude/agents/listabackend-implementer.md.ls .claude/skills/listacreate-story/,implement-feature/,open-pull-request/.git check-ignore -v .claude/stories/qualquer.mdconfirma que está ignorado pelo.gitignore..mdadicionados.bundle exec rspecsegue passando (este PR não toca código de aplicação).bundle exec rubocop -Dsegue limpo dentro da baseline (este PR não toca código de aplicação).Notas de revisão
/Users/naroga/Projects/elife/buzzmonitor/gmail/.claude/agent-memory/backend-implementer/para memória persistente. Esse caminho é específico da máquina do desenvolvedor que rodou o bootstrap — outros contribuidores que clonarem o repo vão ter caminhos diferentes. É aceitável aqui porque.claude/agent-memory/também é per-developer e não fica comitada (não está no PR; e pode ser adicionada ao.gitignorefuturamente se alguém criar essa pasta).masternão tem GHA ainda (PR chore: bootstrap dos quality gates (CI + precommit + baseline de lint) #1 introduz). Quando a PR chore: bootstrap dos quality gates (CI + precommit + baseline de lint) #1 mergear, podemos rescaffoldar para adicionar um agentinfrastructureseparadamente.