How facundodlf/asdd-ai-workflow works
ASDD is a documentation-based methodology for governing AI-assisted software changes, not a runtime application. Its principal workflow takes approved intent through repository scanning, planning, ticket governance, loop-verified implementation, and PR handoff. The README documents the overall pipeline and identifies the master workflow, reusable skills, profile overlays, and templates; source excerpts were unavailable, so relationships below rely on those documented statements rather than inferred calls.
Main entry points: skills FE/BE overlays · spec-intake.md Spec intake · ticket-author.md Ticket authoring · implementation-loop.md Implementation loop
Components 17
Delivery workflow
- Spec intake
skills/spec-intake.md - Viability scan
skills/repo-viability-scan.md - Action plan
skills/action-plan-builder.md - Ticket authoring
skills/ticket-author.md - Ticket quality gate
skills/ticket-quality-gate.md - Implementation loop
skills/implementation-loop.md - PR handoff
skills/pr-handoff.md - Master workflow
ASDD.md
Reusable skills
- FE/BE overlays
skills
Project integration
- Agent instructions
AGENTS.md
Workflow artifacts
- Instruction templates
templates/AGENTS.md.fe.example - Ticket template
templates/ticket.fe.md - Bootstrap prompt
prompts/bootstrap.md - Loop verification prompt
prompts/loop-self-verify.md
Other components
- Developer
- AI coding agent
- Consumer project
Connections 23
- Developer → Spec intake: provides approved intent
README.md - AI coding agent → Master workflow: follows methodology
README.md - Master workflow → Spec intake: starts with spec
README.md - Spec intake → Viability scan: then scans
README.md - Viability scan → Action plan: then plans
README.md - Action plan → Ticket authoring: then authors ticket
README.md - Ticket authoring → Ticket quality gate: passes governance gate
README.md - Ticket quality gate → Implementation loop: gates build
README.md - Implementation loop → PR handoff: hands off PR
README.md - PR handoff → Consumer project: delivers change
README.md - AI coding agent → Agent instructions: reads instructions
README.md - Agent instructions → Master workflow: points agents to
README.md - FE/BE overlays → Spec intake: adapts profiles
README.md - FE/BE overlays → Viability scan: adapts profiles
README.md - FE/BE overlays → Action plan: adapts profiles
README.md - FE/BE overlays → Ticket authoring: adapts profiles
README.md - FE/BE overlays → Ticket quality gate: adapts profiles
README.md - FE/BE overlays → Implementation loop: adapts profiles
README.md - FE/BE overlays → PR handoff: adapts profiles
README.md - Instruction templates → Agent instructions: provides setup pattern
README.md - Ticket template → Ticket authoring: formats ticket
README.md - Bootstrap prompt → Agent instructions: supports adoption
- Loop verification prompt → Implementation loop: supports verification