# facundodlf/asdd-ai-workflow architecture

> Architecture diagram of the GitHub repository facundodlf/asdd-ai-workflow, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/facundodlf/asdd-ai-workflow
- Repository: https://github.com/facundodlf/asdd-ai-workflow

## Overview

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`](https://github.com/facundodlf/asdd-ai-workflow/tree/main/skills) (FE/BE overlays), [`skills/spec-intake.md`](https://github.com/facundodlf/asdd-ai-workflow/blob/main/skills/spec-intake.md) (Spec intake), [`skills/ticket-author.md`](https://github.com/facundodlf/asdd-ai-workflow/blob/main/skills/ticket-author.md) (Ticket authoring), [`skills/implementation-loop.md`](https://github.com/facundodlf/asdd-ai-workflow/blob/main/skills/implementation-loop.md) (Implementation loop)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Delivery workflow"]
  node_spec["Spec intake<br/>[spec-intake.md]"]
  node_repo_scan["Viability scan"]
  node_action_plan["Action plan"]
  node_ticket_author["Ticket authoring<br/>[ticket-author.md]"]
  node_quality_gate["Ticket quality gate"]
  node_implementation["Implementation loop"]
  node_pr_handoff["PR handoff<br/>[pr-handoff.md]"]
  node_master_workflow["Master workflow<br/>[ASDD.md]"]
end

subgraph group_skills["Reusable skills"]
  node_profile_overlays["FE/BE overlays"]
end

subgraph group_adoption["Project integration"]
  node_connection_anchor["Agent instructions<br/>[AGENTS.md]"]
end

subgraph group_artifacts["Workflow artifacts"]
  node_agent_templates["Instruction templates"]
  node_ticket_template["Ticket template<br/>[ticket.fe.md]"]
  node_bootstrap_prompt["Bootstrap prompt<br/>[bootstrap.md]"]
  node_loop_prompt["Loop verification prompt"]
end

node_developer(("Developer"))
node_ai_agent(("AI coding agent"))
node_project["Consumer project"]

node_developer -->|"provides approved intent"| node_spec
node_ai_agent -->|"follows methodology"| node_master_workflow
node_master_workflow -->|"starts with spec"| node_spec
node_spec -->|"then scans"| node_repo_scan
node_repo_scan -->|"then plans"| node_action_plan
node_action_plan -->|"then authors ticket"| node_ticket_author
node_ticket_author -->|"passes governance gate"| node_quality_gate
node_quality_gate -->|"gates build"| node_implementation
node_implementation -->|"hands off PR"| node_pr_handoff
node_pr_handoff -->|"delivers change"| node_project
node_ai_agent -->|"reads instructions"| node_connection_anchor
node_connection_anchor -->|"points agents to"| node_master_workflow
node_profile_overlays -->|"adapts profiles"| node_spec
node_profile_overlays -->|"adapts profiles"| node_repo_scan
node_profile_overlays -->|"adapts profiles"| node_action_plan
node_profile_overlays -->|"adapts profiles"| node_ticket_author
node_profile_overlays -->|"adapts profiles"| node_quality_gate
node_profile_overlays -->|"adapts profiles"| node_implementation
node_profile_overlays -->|"adapts profiles"| node_pr_handoff
node_agent_templates -->|"provides setup pattern"| node_connection_anchor
node_ticket_template -->|"formats ticket"| node_ticket_author
node_bootstrap_prompt -.->|"supports adoption"| node_connection_anchor
node_loop_prompt -.->|"supports verification"| node_implementation

click node_spec "https://github.com/facundodlf/asdd-ai-workflow/blob/main/skills/spec-intake.md"
click node_repo_scan "https://github.com/facundodlf/asdd-ai-workflow/blob/main/skills/repo-viability-scan.md"
click node_action_plan "https://github.com/facundodlf/asdd-ai-workflow/blob/main/skills/action-plan-builder.md"
click node_ticket_author "https://github.com/facundodlf/asdd-ai-workflow/blob/main/skills/ticket-author.md"
click node_quality_gate "https://github.com/facundodlf/asdd-ai-workflow/blob/main/skills/ticket-quality-gate.md"
click node_implementation "https://github.com/facundodlf/asdd-ai-workflow/blob/main/skills/implementation-loop.md"
click node_pr_handoff "https://github.com/facundodlf/asdd-ai-workflow/blob/main/skills/pr-handoff.md"
click node_master_workflow "https://github.com/facundodlf/asdd-ai-workflow/blob/main/ASDD.md"
click node_profile_overlays "https://github.com/facundodlf/asdd-ai-workflow/tree/main/skills"
click node_connection_anchor "https://github.com/facundodlf/asdd-ai-workflow/blob/main/AGENTS.md"
click node_agent_templates "https://github.com/facundodlf/asdd-ai-workflow/blob/main/templates/AGENTS.md.fe.example"
click node_ticket_template "https://github.com/facundodlf/asdd-ai-workflow/blob/main/templates/ticket.fe.md"
click node_bootstrap_prompt "https://github.com/facundodlf/asdd-ai-workflow/blob/main/prompts/bootstrap.md"
click node_loop_prompt "https://github.com/facundodlf/asdd-ai-workflow/blob/main/prompts/loop-self-verify.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_spec,node_repo_scan,node_action_plan,node_ticket_author,node_quality_gate,node_implementation,node_pr_handoff,node_master_workflow toneBlue
class node_profile_overlays toneAmber
class node_connection_anchor toneMint
class node_agent_templates,node_ticket_template,node_bootstrap_prompt,node_loop_prompt toneRose
class node_developer,node_ai_agent,node_project toneIndigo
```

## Components

### Delivery workflow

- [Spec intake](https://github.com/facundodlf/asdd-ai-workflow/blob/main/skills/spec-intake.md): `skills/spec-intake.md`
- [Viability scan](https://github.com/facundodlf/asdd-ai-workflow/blob/main/skills/repo-viability-scan.md): `skills/repo-viability-scan.md`
- [Action plan](https://github.com/facundodlf/asdd-ai-workflow/blob/main/skills/action-plan-builder.md): `skills/action-plan-builder.md`
- [Ticket authoring](https://github.com/facundodlf/asdd-ai-workflow/blob/main/skills/ticket-author.md): `skills/ticket-author.md`
- [Ticket quality gate](https://github.com/facundodlf/asdd-ai-workflow/blob/main/skills/ticket-quality-gate.md): `skills/ticket-quality-gate.md`
- [Implementation loop](https://github.com/facundodlf/asdd-ai-workflow/blob/main/skills/implementation-loop.md): `skills/implementation-loop.md`
- [PR handoff](https://github.com/facundodlf/asdd-ai-workflow/blob/main/skills/pr-handoff.md): `skills/pr-handoff.md`
- [Master workflow](https://github.com/facundodlf/asdd-ai-workflow/blob/main/ASDD.md): `ASDD.md`

### Reusable skills

- [FE/BE overlays](https://github.com/facundodlf/asdd-ai-workflow/tree/main/skills): `skills`

### Project integration

- [Agent instructions](https://github.com/facundodlf/asdd-ai-workflow/blob/main/AGENTS.md): `AGENTS.md`

### Workflow artifacts

- [Instruction templates](https://github.com/facundodlf/asdd-ai-workflow/blob/main/templates/AGENTS.md.fe.example): `templates/AGENTS.md.fe.example`
- [Ticket template](https://github.com/facundodlf/asdd-ai-workflow/blob/main/templates/ticket.fe.md): `templates/ticket.fe.md`
- [Bootstrap prompt](https://github.com/facundodlf/asdd-ai-workflow/blob/main/prompts/bootstrap.md): `prompts/bootstrap.md`
- [Loop verification prompt](https://github.com/facundodlf/asdd-ai-workflow/blob/main/prompts/loop-self-verify.md): `prompts/loop-self-verify.md`

### Other components

- **Developer**
- **AI coding agent**
- **Consumer project**

## Connections

- Developer → Spec intake: provides approved intent (evidence: `README.md`)
- AI coding agent → Master workflow: follows methodology (evidence: `README.md`)
- Master workflow → Spec intake: starts with spec (evidence: `README.md`)
- Spec intake → Viability scan: then scans (evidence: `README.md`)
- Viability scan → Action plan: then plans (evidence: `README.md`)
- Action plan → Ticket authoring: then authors ticket (evidence: `README.md`)
- Ticket authoring → Ticket quality gate: passes governance gate (evidence: `README.md`)
- Ticket quality gate → Implementation loop: gates build (evidence: `README.md`)
- Implementation loop → PR handoff: hands off PR (evidence: `README.md`)
- PR handoff → Consumer project: delivers change (evidence: `README.md`)
- AI coding agent → Agent instructions: reads instructions (evidence: `README.md`)
- Agent instructions → Master workflow: points agents to (evidence: `README.md`)
- FE/BE overlays → Spec intake: adapts profiles (evidence: `README.md`)
- FE/BE overlays → Viability scan: adapts profiles (evidence: `README.md`)
- FE/BE overlays → Action plan: adapts profiles (evidence: `README.md`)
- FE/BE overlays → Ticket authoring: adapts profiles (evidence: `README.md`)
- FE/BE overlays → Ticket quality gate: adapts profiles (evidence: `README.md`)
- FE/BE overlays → Implementation loop: adapts profiles (evidence: `README.md`)
- FE/BE overlays → PR handoff: adapts profiles (evidence: `README.md`)
- Instruction templates → Agent instructions: provides setup pattern (evidence: `README.md`)
- Ticket template → Ticket authoring: formats ticket (evidence: `README.md`)
- Bootstrap prompt → Agent instructions: supports adoption
- Loop verification prompt → Implementation loop: supports verification