feat(aidd-craft): start a project from scratch with craft practices

Aberta
#1,259 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
5/5
Tempo estimado
Mais de uma semana
Facilidade para iniciantes
35/100
Tipo de issue
Funcionalidade
Clareza
Razoavelmente clara
Status de atividade
Ativa
Stack de tecnologia
typescript

Direção de pesquisa

Start with the linked child issues #1260–#1265 and read the existing aidd-context rule generator, project memory, and onboarding flow; those are the named integration points. Then review how aidd-orchestrator dispatches isolated runs and how aidd-telemetry measures tokens. Done means the opt-in and init/tdd flow meet the listed success evidence, including test-first behavior, chosen rules, architecture, and recorded run duration.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

Outcome

A developer starting an empty project can opt into craft practices and ship the first use case test-driven, the architecture emerging from it.

Context and value

Developers who practice craftsmanship, or want to learn it, get the practices without writing their own prompts. Projects that do not want them never see them: the plugin is opt-in.

Boundaries

  • Includes: the onboarding opt-in; init (default rules, optional practices, expected architecture in project memory); tdd (analyze, then cycle; interactive and autonomous).
  • Excludes: audit, BDD and Example Mapping, Event Storming, iteration typing, scaffolding, new agents, any change to aidd-dev.

Principles

  • Rules carry the practice content; skills stay light and deterministic.
  • aidd-context writes the rules and the project memory; aidd-craft supplies their content.
  • No scaffolding: memory describes the expected architecture (one Bounded Context to start, one Clean Architecture per context), the first use case built test-driven creates it.
  • Coexists with aidd-context:01-bootstrap: bootstrap decides the deployable units and stops at src/, craft describes what lives inside.
  • Tool- and cloud-agnostic. Practice terms are worded neutrally.

Success evidence

On an empty project, the onboarding asks, options are chosen, and the first use case goes through tdd:

  • every behavior had a failing test before its code;
  • the resulting tree matches the architecture described in memory;
  • only the chosen rules are installed;
  • tokens per iteration are measured with aidd telemetry, one declared task per iteration, and the run's duration is recorded alongside, since telemetry counts tokens, not time.

Dependencies and unknowns

Item Kind Handling
aidd-context rule generator and project memory dependency craft supplies content, never writes rules itself
aidd-orchestrator dispatching two isolated runs dependency story: autonomous TDD
Mutation testing decision separate task
aidd-telemetry, beta and opt-in dependency needed only to measure the success evidence

Children

  • #1260
  • #1261
  • #1262
  • #1263
  • #1264
  • #1265
Linguagem predominante
TypeScript
Estrelas
481
Forks
45
Merge médio
1d 13h
PRs com merge (30d)
91

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de ai-driven-dev/framework

Todas as issues de ai-driven-dev/framework

Issues semelhantes

Mais issues de TypeScript

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.