Communitygithub.com

JahacksV1/day-one-agent-kit

Entenda um repositório sem alterar sua arquitetura. Use ao iniciar o trabalho em um repositório desconhecido, ao integrar um código-fonte de cliente ou ao criar uma linha de base de stack/perfil.

O que é day-one-agent-kit?

Este kit de agente (JahacksV1/day-one-agent-kit) foi projetado para desenvolvedores que precisam compreender rapidamente um repositório de código desconhecido sem modificar sua arquitetura. Ele gera um perfil conciso e baseado em evidências do projeto, destacando riscos e próximos passos, ideal para onboarding em bases de clientes, início de trabalho em repositórios não familiares ou criação de uma linha de base de stack. O agente funciona analisando arquivos de configuração, scripts, entry points e padrões de código para mapear áreas como frontend, backend, banco de dados, autenticação e IA, citando evidências concretas de cada descoberta. Suporta projetos em qualquer linguagem ou framework (Node.js, Python, etc.) desde que haja arquivos de manifesto como `package.json` ou `pyproject.toml`. A saída principal é um arquivo `.ai/PROJECT_PROFILE.md`, mantendo o perfil curto e acionável, evitando suposições e marcando áreas não aplicáveis como 'Não Aplicável' em vez de inventar conteúdo.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JahacksV1/day-one-agent-kit/tree/HEAD/skills/intake-repo

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Intake Repo

Use este fluxo de trabalho para entender rapidamente um repositório antes da implementação.

Objetivo

Produzir um perfil curto e baseado em evidências do repositório, com riscos e próximos passos.

Saída

  • .ai/PROJECT_PROFILE.md usando templates/PROJECT_PROFILE.md.

Regras

  • Não edite o código do produto.
  • Não reescreva a arquitetura.
  • Prefira padrões de código observados em vez de suposições.
  • Mantenha o perfil conciso e acionável.
  • "Não Aplicável" é uma resposta válida e esperada para uma Área Principal — um site estático/portfólio sem backend não tem autenticação, banco de dados ou lógica de IA para preencher. Marque como Não Aplicável em vez de inventar conteúdo, adivinhar uma necessidade futura ou deixar em branco/ambíguo.

Passos

  1. Detecte framework, linguagem, gerenciador de pacotes e alvo de implantação.
  2. Leia arquivos de pacote/lock/config e pontos de entrada principais.
  3. Identifique scripts disponíveis: dev, typecheck, lint, test, build.
  4. Mapeie áreas de frontend, backend, banco de dados, autenticação, IA e implantação.
  5. Identifique padrões de uso de variáveis de ambiente.
  6. Capture padrões de arquitetura atuais usados no código.
  7. Liste itens básicos de produção ausentes e riscos principais.
  8. Gere ou atualize .ai/PROJECT_PROFILE.md.

Evidência Mínima

Cite arquivos concretos para cada descoberta. Exemplos de categorias:

  • fonte de script (package.json, pyproject.toml, etc.)
  • fonte de implantação (vercel.json, Docker, workflows de CI)
  • fonte de uso de env (process.env, NEXT_PUBLIC_, etc.)
  • limites de autenticação/dados (middleware, manipuladores de rota, arquivos de política)

Verificação de Conclusão

  • O perfil inclui stack detectada, scripts, áreas principais, padrões, riscos.
  • A saída é curta o suficiente para ser útil durante tarefas normais de codificação.

Habilidades Relacionadas