/factory-architect

name: factory-architect
description: Use when orchestrating an architecture lifecycle (specify/init → clarify → implement → analyze) to generate or maintain AD.md.
disable-model-invocation: true

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.