# mingyuepop/specforge architecture

> Architecture diagram of the GitHub repository mingyuepop/specforge, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mingyuepop/specforge
- Repository: https://github.com/mingyuepop/specforge

## Overview

SpecForge is a collection of AI-assisted development workflow skills, organized around project setup, repeatable feature work, and on-demand maintenance. The documented project workflow turns an idea into project specifications and an initialized skeleton; feature work then proceeds from clarified requirements through design and planning to implementation. The README also describes guardrails and a project-context protocol applied across skills. No source excerpts were provided, so relationships below rely on the README’s documented workflow; the graph uses V3 paths for the current-looking skill layout.

Main entry points: [`V3/skills/project/project-requirements-clarification/SKILL.md`](https://github.com/mingyuepop/specforge/blob/main/V3/skills/project/project-requirements-clarification/SKILL.md) (Project requirements), [`V3/skills/feature/feature-implementation/SKILL.md`](https://github.com/mingyuepop/specforge/blob/main/V3/skills/feature/feature-implementation/SKILL.md) (Implementation), [`V3/specs/GUARDRAILS.md`](https://github.com/mingyuepop/specforge/blob/main/V3/specs/GUARDRAILS.md) (Stage guardrails), [`V3/specs/PROJECT-CONTEXT.md`](https://github.com/mingyuepop/specforge/blob/main/V3/specs/PROJECT-CONTEXT.md) (Project context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_project["Project setup"]
  node_req_project["Project requirements<br/>[SKILL.md]"]
  node_overview["Product overview<br/>[SKILL.md]"]
  node_techstack["Tech stack<br/>[SKILL.md]"]
  node_structure["Project structure<br/>[SKILL.md]"]
  node_standards["Dev standards<br/>[SKILL.md]"]
  node_roadmap["Roadmap planning<br/>[SKILL.md]"]
  node_initialization["Project initialization<br/>[SKILL.md]"]
end

subgraph group_feature["Feature workflow"]
  node_req_feature["Feature requirements<br/>[SKILL.md]"]
  node_design["Tech design<br/>[SKILL.md]"]
  node_taskplan["Task planning<br/>[SKILL.md]"]
  node_implementation["Implementation<br/>[SKILL.md]"]
  node_evolution["Feature evolution<br/>[SKILL.md]"]
end

subgraph group_maintenance["Maintenance"]
  node_bugfix["Bugfix workflow<br/>[SKILL.md]"]
end

subgraph group_protocol["Workflow protocols"]
  node_guardrails["Stage guardrails<br/>[GUARDRAILS.md]"]
  node_context["Project context<br/>[PROJECT-CONTEXT.md]"]
end

node_user(("User"))

node_user -->|"starts with"| node_req_project
node_req_project -->|"informs"| node_overview
node_overview -->|"informs"| node_techstack
node_techstack -->|"guides"| node_structure
node_structure -->|"precedes"| node_standards
node_standards -->|"precedes"| node_roadmap
node_roadmap -->|"guides"| node_initialization
node_user -->|"starts feature"| node_req_feature
node_req_feature -->|"informs"| node_design
node_design -->|"informs"| node_taskplan
node_taskplan -->|"guides"| node_implementation
node_user -->|"requests change"| node_evolution
node_evolution -->|"guides"| node_implementation
node_user -->|"requests fix"| node_bugfix
node_guardrails -->|"constrains stages"| node_req_project
node_guardrails -->|"constrains stages"| node_implementation
node_context -->|"provides context"| node_req_project
node_context -->|"provides context"| node_implementation

click node_req_project "https://github.com/mingyuepop/specforge/blob/main/V3/skills/project/project-requirements-clarification/SKILL.md"
click node_overview "https://github.com/mingyuepop/specforge/blob/main/V3/skills/project/project-product-overview/SKILL.md"
click node_techstack "https://github.com/mingyuepop/specforge/blob/main/V3/skills/project/project-tech-stack/SKILL.md"
click node_structure "https://github.com/mingyuepop/specforge/blob/main/V3/skills/project/project-structure/SKILL.md"
click node_standards "https://github.com/mingyuepop/specforge/blob/main/V3/skills/project/project-dev-standards/SKILL.md"
click node_roadmap "https://github.com/mingyuepop/specforge/blob/main/V3/skills/project/project-roadmap-planning/SKILL.md"
click node_initialization "https://github.com/mingyuepop/specforge/blob/main/V3/skills/project/project-initialization/SKILL.md"
click node_req_feature "https://github.com/mingyuepop/specforge/blob/main/V3/skills/feature/feature-requirements-clarification/SKILL.md"
click node_design "https://github.com/mingyuepop/specforge/blob/main/V3/skills/feature/feature-tech-design/SKILL.md"
click node_taskplan "https://github.com/mingyuepop/specforge/blob/main/V3/skills/feature/feature-task-planning/SKILL.md"
click node_implementation "https://github.com/mingyuepop/specforge/blob/main/V3/skills/feature/feature-implementation/SKILL.md"
click node_evolution "https://github.com/mingyuepop/specforge/blob/main/V3/skills/feature/feature-evolution/SKILL.md"
click node_bugfix "https://github.com/mingyuepop/specforge/blob/main/V3/skills/bugfix-workflow/SKILL.md"
click node_guardrails "https://github.com/mingyuepop/specforge/blob/main/V3/specs/GUARDRAILS.md"
click node_context "https://github.com/mingyuepop/specforge/blob/main/V3/specs/PROJECT-CONTEXT.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_req_project,node_overview,node_techstack,node_structure,node_standards,node_roadmap,node_initialization,node_user toneBlue
class node_req_feature,node_design,node_taskplan,node_implementation,node_evolution toneAmber
class node_bugfix toneMint
class node_guardrails,node_context toneRose
```

## Components

### Project setup

- [Project requirements](https://github.com/mingyuepop/specforge/blob/main/V3/skills/project/project-requirements-clarification/SKILL.md): `V3/skills/project/project-requirements-clarification/SKILL.md`
- [Product overview](https://github.com/mingyuepop/specforge/blob/main/V3/skills/project/project-product-overview/SKILL.md): `V3/skills/project/project-product-overview/SKILL.md`
- [Tech stack](https://github.com/mingyuepop/specforge/blob/main/V3/skills/project/project-tech-stack/SKILL.md): `V3/skills/project/project-tech-stack/SKILL.md`
- [Project structure](https://github.com/mingyuepop/specforge/blob/main/V3/skills/project/project-structure/SKILL.md): `V3/skills/project/project-structure/SKILL.md`
- [Dev standards](https://github.com/mingyuepop/specforge/blob/main/V3/skills/project/project-dev-standards/SKILL.md): `V3/skills/project/project-dev-standards/SKILL.md`
- [Roadmap planning](https://github.com/mingyuepop/specforge/blob/main/V3/skills/project/project-roadmap-planning/SKILL.md): `V3/skills/project/project-roadmap-planning/SKILL.md`
- [Project initialization](https://github.com/mingyuepop/specforge/blob/main/V3/skills/project/project-initialization/SKILL.md): `V3/skills/project/project-initialization/SKILL.md`

### Feature workflow

- [Feature requirements](https://github.com/mingyuepop/specforge/blob/main/V3/skills/feature/feature-requirements-clarification/SKILL.md): `V3/skills/feature/feature-requirements-clarification/SKILL.md`
- [Tech design](https://github.com/mingyuepop/specforge/blob/main/V3/skills/feature/feature-tech-design/SKILL.md): `V3/skills/feature/feature-tech-design/SKILL.md`
- [Task planning](https://github.com/mingyuepop/specforge/blob/main/V3/skills/feature/feature-task-planning/SKILL.md): `V3/skills/feature/feature-task-planning/SKILL.md`
- [Implementation](https://github.com/mingyuepop/specforge/blob/main/V3/skills/feature/feature-implementation/SKILL.md): `V3/skills/feature/feature-implementation/SKILL.md`
- [Feature evolution](https://github.com/mingyuepop/specforge/blob/main/V3/skills/feature/feature-evolution/SKILL.md): `V3/skills/feature/feature-evolution/SKILL.md`

### Maintenance

- [Bugfix workflow](https://github.com/mingyuepop/specforge/blob/main/V3/skills/bugfix-workflow/SKILL.md): `V3/skills/bugfix-workflow/SKILL.md`

### Workflow protocols

- [Stage guardrails](https://github.com/mingyuepop/specforge/blob/main/V3/specs/GUARDRAILS.md): `V3/specs/GUARDRAILS.md`
- [Project context](https://github.com/mingyuepop/specforge/blob/main/V3/specs/PROJECT-CONTEXT.md): `V3/specs/PROJECT-CONTEXT.md`

### Other components

- **User**

## Connections

- User → Project requirements: starts with (evidence: `README.md`)
- Project requirements → Product overview: informs (evidence: `README.md`)
- Product overview → Tech stack: informs (evidence: `README.md`)
- Tech stack → Project structure: guides (evidence: `README.md`)
- Project structure → Dev standards: precedes (evidence: `README.md`)
- Dev standards → Roadmap planning: precedes (evidence: `README.md`)
- Roadmap planning → Project initialization: guides (evidence: `README.md`)
- User → Feature requirements: starts feature (evidence: `README.md`)
- Feature requirements → Tech design: informs (evidence: `README.md`)
- Tech design → Task planning: informs (evidence: `README.md`)
- Task planning → Implementation: guides (evidence: `README.md`)
- User → Feature evolution: requests change (evidence: `README.md`)
- Feature evolution → Implementation: guides (evidence: `README.md`)
- User → Bugfix workflow: requests fix (evidence: `README.md`)
- Stage guardrails → Project requirements: constrains stages (evidence: `README.md`)
- Stage guardrails → Implementation: constrains stages (evidence: `README.md`)
- Project context → Project requirements: provides context (evidence: `README.md`)
- Project context → Implementation: provides context (evidence: `README.md`)
