Skip to content

Commit 2e372a6

Browse files
easelclaude
andcommitted
chore(docs): add DDx service dependencies to architecture.md [hx-2da025c0]
System Components now lists DDx agent service (ddx agent run) and DDx bead service (ddx bead) as external dependencies per PRD lines 55-63. Data Flow inserts delegation steps for harness dispatch and beads queries. Governing artifact: helix.prd (Dependencies section) Verified: acceptance criteria satisfied — both sections reference both services. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent d231f76 commit 2e372a6

1 file changed

Lines changed: 12 additions & 3 deletions

File tree

docs/helix/02-design/architecture.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -41,14 +41,23 @@ prompt envelopes by default, with optional auto execution when configured.
4141
- **Drift Analyzer**: compares docs and code to identify misalignment.
4242
- **Change Planner**: produces ordered updates across artifacts.
4343
- **Automation Policy**: enforces manual/plan/auto/yolo behavior.
44+
- **DDx Agent Service** (`ddx agent run`): external service for agent-type
45+
checks that require harness dispatch. Dun delegates agent invocation, quorum,
46+
and session logging to DDx rather than owning its own harness abstraction.
47+
- **DDx Bead Service** (`ddx bead`): external service for beads-aware check
48+
types (beads-ready, beads-critical-path, beads-suggest). Dun queries beads
49+
via `ddx bead` commands, not by reading storage files directly.
4450

4551
## Data Flow
4652

4753
1. CLI loads plugins and builds a plan.
4854
2. Rule checks run and emit results.
49-
3. Agent checks emit prompt envelopes (default).
50-
4. Optional auto mode runs the agent and parses responses.
51-
5. Drift analyzer and planner identify downstream changes when docs shift.
55+
3. Agent checks delegate to DDx agent service (`ddx agent run`) for harness
56+
dispatch, quorum, and session logging.
57+
4. Beads-aware checks query DDx bead service (`ddx bead`) for work-item state.
58+
5. Agent checks emit prompt envelopes (default).
59+
6. Optional auto mode runs the agent and parses responses.
60+
7. Drift analyzer and planner identify downstream changes when docs shift.
5261

5362
## Command Flows
5463

0 commit comments

Comments
 (0)