factory-architect

factory-architect

What this skill does

factory-architect orchestrates the architecture-decisions lifecycle. It coordinates individual architecture-related skills (architect-init, architect-specify, architect-clarify, architect-implement, architect-analyze) to maintain a consistent AD.md at the project root.

It operates as a Kind-A DAG orchestrator in alignment with the shared executor engine contract in factory-mission/references/executor.md.

---

When to use

• You want to bootstrap, refine, or analyze a project's system-level design and decisions (ADRs) end-to-end.
• You want to verify that architectural viewpoints conform to the Rozanski & Woods methodology.

When NOT to use:

• For product-requirements definition (use factory-product instead).
• For feature-level software execution (use factory-mission instead).

---

Lifecycle DAG & Step Resolution

factory-architect implements a fixed named-skill DAG (fixed step resolution):

Greenfield Route (default on empty project)

1. specify (generate phase) -> Invoke architect-specify to collaboratively capture ADR drafts in .adlc/drafts/adr/.
2. clarify⭐ (clarify phase) -> Invoke architect-clarify to run interactive quality checks and mark ADRs Accepted (human sign-off gate).
3. implement (build phase) -> Invoke architect-implement to compile accepted ADRs into AD.md (by sub-systems) and promote them to docs/adlc/memory/adr/.
4. analyze (analyze phase) -> Invoke architect-analyze to verify AD/ADR consistency and output a severity-ranked report.

Brownfield Route (default if code exists but no ADRs)

1. init (generate phase) -> Invoke architect-init to reverse-engineer draft ADRs from the existing architecture.
2. clarify⭐ → implement → analyze (same as Greenfield).

Refresh Route (default if AD.md and memory ADRs already exist)

1. analyze (analyze phase) -> Run architect-analyze first to detect drift.
2. clarify⭐ → implement → analyze (drift-correction cycle).

---

Shared Executor Overrides

factory-architect overrides the shared executor engine primitives as follows:

1. Publish Target: Fixed to local. Outputs are written to docs/adlc/memory/adr/ and docs/adlc/architect/AD.md. If tracker-integrated, a tracker completion summary comment is also posted.
2. Output Types: Steps use the following output_type assignments:
   • specify/init → draft (ADR drafts stay in .adlc/drafts/adr/, not published to comment bus)
   • clarify⭐ → decision (accepted/rejected ADR list published to comment bus)
   • implement → artifact-ref (AD.md path reference published, content stays on disk)
   • analyze → findings (severity-ranked consistency report published to comment bus)
3. Correction Loop: If analyze returns CRITICAL or HIGH consistency errors, the executor routes back to clarify with the analyze marker in reads_from. clarify reads the findings from the PR/MR/issue comment bus (or local fallback). This loop is bounded by max_corrections (default 2); if exceeded, the orchestrator halts for human review.
4. Supervision Default: hybrid. A human gate is hard-enforced at clarify⭐ (for ADR approvals) and at final AD.md review.
5. Pre-flight Check: Verifies that the architect-* lifecycle skills are installed in the workspace before beginning Phase 0.