fix(docs): align ASCII box-drawing diagrams across 23 files

Fix right-side │ border alignment in box diagrams. Three fix types:
- Trailing space adjustment for border alignment
- Box border widening for content that exceeded width
- Bottom border dash count matching top border
This commit is contained in:
Boden Fuller
2026-03-29 07:55:25 -04:00
parent f911bef994
commit 03a97978c5
23 changed files with 182 additions and 182 deletions
+1 -1
View File
@@ -11,7 +11,7 @@ The architecture rests on five pillars. Each one is independent — you can use
``` ```
┌─────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────┐
│ DevOps Three Ways │ │ DevOps Three Ways │
│ (Flow · Feedback · Continual Learning) │ │ (Flow · Feedback · Continual Learning) │
├─────────────┬─────────────┬─────────────┬───────────────────────┤ ├─────────────┬─────────────┬─────────────┬───────────────────────┤
│ Brownian │ Ralph │ Knowledge │ Fractal │ │ Brownian │ Ralph │ Knowledge │ Fractal │
│ Ratchet │ Wiggum │ Flywheel │ Composition │ │ Ratchet │ Wiggum │ Flywheel │ Composition │
+25 -25
View File
@@ -19,40 +19,40 @@ The validate workflow runs **29 jobs** across 4 tiers of parallelism. Most jobs
### Job Dependency Graph ### Job Dependency Graph
```text ```text
┌─────────────────────────────────────────────┐ ┌───────────────────────────────────────────────┐
│ 25 independent parallel jobs │ │ 25 independent parallel jobs │
│ │ │ │
│ doc-release-gate smoke-test │ │ doc-release-gate smoke-test │
│ hook-preflight validate-hooks-doc-parity│ │ hook-preflight validate-hooks-doc-parity│
│ validate-ci-policy-parity │ │ validate-ci-policy-parity │
│ codex-runtime-sections │ │ codex-runtime-sections │
│ embedded-sync cli-docs-parity │ │ embedded-sync cli-docs-parity │
│ shellcheck markdownlint │ │ shellcheck markdownlint │
│ security-scan security-toolchain-gate │ │ security-scan security-toolchain-gate │
│ skill-integrity skill-schema │ │ skill-integrity skill-schema │
│ skill-dependency-check │ │ skill-dependency-check │
│ contract-compatibility-gate │ │ contract-compatibility-gate │
│ memrl-health plugin-load-test │ │ memrl-health plugin-load-test │
│ go-build cli-integration │ │ go-build cli-integration │
│ file-manifest-overlap │ │ file-manifest-overlap │
│ skill-lint learning-coherence │ │ skill-lint learning-coherence │
│ bats-tests check-test-staleness │ │ bats-tests check-test-staleness │
└──────────────┬──────────────────────────────┘ └────────────────┬──────────────────────────────┘
│ │
┌──────────────┴──────────────┐ ┌──────────────┴──────────────┐
│ go-build (must complete) │ │ go-build (must complete) │
└──┬─────────────┬─────────┬──┘ └──┬─────────────┬─────────┬──┘
│ │ │ │ │ │
┌─────┴──┐ ┌──────┴───┐ ┌───┴──────────┐ ┌─────┴──┐ ┌──────┴───┐ ┌───┴──────────┐
│ doctor- │ │coverage- │ │json-flag- │ │ doctor- │ │coverage- │ │json-flag- │
│ check │ │ ratchet │ │consistency │ │ check │ │ ratchet │ │consistency │
└────┬────┘ └────┬─────┘ └──────┬───────┘ └────┬────┘ └────┬─────┘ └──────┬──────┘
│ │ │ │ │ │
┌─┴────────────┴──────────────┴─┐ ┌─┴────────────┴──────────────┴─┐
│ summary │ │ summary │
│ (needs: ALL 28 jobs) │ │ (needs: ALL 28 jobs) │
│ if: always() │ │ if: always() │
└────────────────────────────────┘ └───────────────────────────────┘
``` ```
### The `summary` Aggregator Pattern ### The `summary` Aggregator Pattern
+10 -10
View File
@@ -10,21 +10,21 @@ Releases are triggered by git tags and use a publisher-only workflow:
git tag vX.Y.Z git tag vX.Y.Z
↓ ↓
┌──────────────────────────────────────────────────────┐ ┌──────────────────────────────────────────────────────┐
│ Local gate (authoritative) │ │ Local gate (authoritative) │
├──────────────────────────────────────────────────────┤ ├──────────────────────────────────────────────────────┤
│ ./scripts/ci-local-release.sh │ │ ./scripts/ci-local-release.sh │
│ - validation + tests + smoke checks │ │ - validation + tests + smoke checks │
│ - hook install + ao rpi smoke │ │ - hook install + ao rpi smoke │
│ - SBOM + security report artifacts │ │ - SBOM + security report artifacts │
└──────────────────────────────────────────────────────┘ └──────────────────────────────────────────────────────┘
↓ ↓
┌──────────────────────────────────────────────────────┐ ┌──────────────────────────────────────────────────────┐
│ release.yml (publisher only) │ │ release.yml (publisher only) │
├──────────────────────────────────────────────────────┤ ├──────────────────────────────────────────────────────┤
│ - GoReleaser publish │ │ - GoReleaser publish │
│ - GitHub Release notes + assets │ │ - GitHub Release notes + assets │
│ - Homebrew update │ │ - Homebrew update │
│ - SLSA provenance attestation │ │ - SLSA provenance attestation │
└──────────────────────────────────────────────────────┘ └──────────────────────────────────────────────────────┘
``` ```
+3 -3
View File
@@ -123,9 +123,9 @@ GOALS.md
``` ```
┌──────────────────────────────┐ ┌──────────────────────────────┐
│ /council │ │ /council │
│ (independent reviewers │ │ (independent reviewers │
│ debate, verdict gates work) │ │ debate, verdict gates work)│
└───────────┬──────────────────┘ └───────────┬──────────────────┘
│ used by │ used by
┌────────────────────┼────────────────────┐ ┌────────────────────┼────────────────────┐
+7 -7
View File
@@ -24,7 +24,7 @@ The top-level skill `/rpi` chains the full pipeline. Each node is a skill. Arrow
┌───────────────────────────────────────────────────────────────────┐ ┌───────────────────────────────────────────────────────────────────┐
│ /rpi │ │ /rpi │
│ (full pipeline orchestrator) │ │ (full pipeline orchestrator) │
└──┬──────────┬───────────┬─────────────┬──────────┬───────────────┘ └──┬──────────┬───────────┬─────────────┬──────────┬─────────────── ┘
│ │ │ │ │ │ │ │ │ │
▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼ ▼
/research /plan /pre-mortem /crank /post-mortem /research /plan /pre-mortem /crank /post-mortem
@@ -33,9 +33,9 @@ The top-level skill `/rpi` chains the full pipeline. Each node is a skill. Arrow
│ │ │ └── calls /retro │ │ │ └── calls /retro
│ │ │ │ │ │
│ │ ┌──────────┴──────────┐ │ │ ┌──────────┴──────────┐
│ │ │ /crank │ │ │ │ /crank │
│ │ │ (wave executor) │ │ │ │ (wave executor) │
│ │ └──────────┬───────────┘ │ │ └──────────┬──────────┘
│ │ │ spawns N parallel │ │ │ spawns N parallel
│ │ ▼ │ │ ▼
│ │ /implement │ │ /implement
@@ -58,9 +58,9 @@ The top-level skill `/rpi` chains the full pipeline. Each node is a skill. Arrow
``` ```
┌──────────────────────────────┐ ┌──────────────────────────────┐
│ /council │ │ /council │
│ (independent judges debate, │ │ (independent judges debate, │
│ verdict gates delivery) │ │ verdict gates delivery) │
└───────────┬──────────────────┘ └───────────┬──────────────────┘
│ used by │ used by
┌────────────────────┼────────────────────┐ ┌────────────────────┼────────────────────┐
+6 -6
View File
@@ -12,14 +12,14 @@ PDC (Prevent, Detect, Correct) is a three-phase framework for maintaining qualit
``` ```
┌──────────────────────────────────────────────────────────┐ ┌──────────────────────────────────────────────────────────┐
│ PREVENT │ │ PREVENT │
│ Stop problems before they enter the system │ │ Stop problems before they enter the system │
├──────────────────────────────────────────────────────────┤ ├──────────────────────────────────────────────────────────┤
│ DETECT │ │ DETECT │
│ Catch problems as soon as they occur │ │ Catch problems as soon as they occur │
├──────────────────────────────────────────────────────────┤ ├──────────────────────────────────────────────────────────┤
│ CORRECT │ │ CORRECT │
│ Fix problems and prevent recurrence │ │ Fix problems and prevent recurrence │
└──────────────────────────────────────────────────────────┘ └──────────────────────────────────────────────────────────┘
``` ```
+6 -6
View File
@@ -81,12 +81,12 @@ FIRE is the reconciliation engine that implements the Brownian Ratchet:
``` ```
┌──────────────────────────────────────────────────────────────┐ ┌──────────────────────────────────────────────────────────────┐
│ FIRE LOOP │ │ FIRE LOOP │
│ │ │ │
│ FIND ────► IGNITE ────► REAP ────► ESCALATE │ │ FIND ────► IGNITE ────► REAP ────► ESCALATE │
│ (state) (chaos) (ratchet) (recovery) │ │ (state) (chaos) (ratchet) (recovery) │
│ │ │ │ │ │ │ │
│ └───────────────────────────────────┘ │ │ └───────────────────────────────────┘ │
│ (loop) │ │ (loop) │
│ │ │ │
│ EXIT when: all work reaped │ │ EXIT when: all work reaped │
@@ -364,8 +364,8 @@ FIRE Loop (Ratchet) Knowledge Flywheel
│ │ │ │
▼ ▼ ▼ ▼
┌─────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────┐
│ NEXT FIRE CYCLE │ │ NEXT FIRE CYCLE │
│ (with better knowledge = faster/cheaper) │ │ (with better knowledge = faster/cheaper) │
└─────────────────────────────────────────────────┘ └─────────────────────────────────────────────────┘
``` ```
+5 -5
View File
@@ -26,11 +26,11 @@ The Claude Code plugin ecosystem has exploded. Here's how the major players stac
│ WHAT OTHERS OPTIMIZE WHAT AGENTOPS OPTIMIZES │ │ WHAT OTHERS OPTIMIZE WHAT AGENTOPS OPTIMIZES │
│ ══════════════════════ ═════════════════════════ │ │ ══════════════════════ ═════════════════════════ │
│ │ │ │
│ Session 1 Session 2 Session 3 Session 1 Session 2 Session 3│ │ Session 1 Session 2 Session 3 Session 1 Session 2 Session 3 │
│ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │ │ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │
│ │ Fast │ │ Fast │ │ Fast │ │Learn │ → │Recall│ → │Expert│ │ │ │ Fast │ │ Fast │ │ Fast │ │Learn │ → │Recall│ → │Expert│ │
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
│ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ │ │ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ │
│ ↓ ↓ ↓ │ │ │ │ │ ↓ ↓ ↓ │ │ │ │
│ [reset] [reset] [reset] └──────────┴──────────┘ │ │ [reset] [reset] [reset] └──────────┴──────────┘ │
│ COMPOUNDS │ │ COMPOUNDS │
+11 -11
View File
@@ -54,9 +54,9 @@ V3 introduced swarms that can adapt their behavior within a session.
┌─────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────┐
│ CLAUDE-FLOW │ │ CLAUDE-FLOW │
│ │ │ │
│ Session 1: 60 agents solve auth bug │ │ Session 1: 60 agents solve auth bug │
│ Session 2: 60 agents solve auth bug (no memory of Session 1) │ │ Session 2: 60 agents solve auth bug (no memory of Session 1) │
│ Session 3: 60 agents solve auth bug (no memory of Session 2) │ │ Session 3: 60 agents solve auth bug (no memory of Session 2) │
│ │ │ │
│ Fast parallel execution, but no compounding │ │ Fast parallel execution, but no compounding │
└─────────────────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────────────┘
@@ -64,8 +64,8 @@ V3 introduced swarms that can adapt their behavior within a session.
┌─────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────┐
│ AGENTOPS │ │ AGENTOPS │
│ │ │ │
│ Session 1: Solve auth bug → Extract: "token refresh" │ │ Session 1: Solve auth bug → Extract: "token refresh" │
│ Session 2: Auth issue? ← Inject prior knowledge │ │ Session 2: Auth issue? ← Inject prior knowledge │
│ Session 3: Auth? ← Instant domain expertise │ │ Session 3: Auth? ← Instant domain expertise │
│ │ │ │
│ Knowledge persists and compounds │ │ Knowledge persists and compounds │
@@ -125,9 +125,9 @@ Claude-Flow excels at coordinating many agents. It doesn't provide the deep sema
┌─────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────┐
│ CLAUDE-FLOW V3 │ │ CLAUDE-FLOW V3 │
│ │ │ │
│ ┌─────────┐ ┌─────────────────────────────────────────┐ │ │ ┌─────────┐ ┌─────────────────────────────────────────┐ │
│ │ Task │───▶│ SWARM COORDINATOR │ │ │ │ Task │───▶│ SWARM COORDINATOR │ │
│ └─────────┘ └─────────────────────────────────────────┘ │ │ └─────────┘ └─────────────────────────────────────────┘ │
│ │ │ │ │ │
│ ┌────────────────────┼────────────────────┐ │ │ ┌────────────────────┼────────────────────┐ │
│ ▼ ▼ ▼ │ │ ▼ ▼ ▼ │
@@ -220,16 +220,16 @@ AgentOps: ████████████░░░░░░░░
│ CLAUDE-FLOW + AGENTOPS │ │ CLAUDE-FLOW + AGENTOPS │
│ │ │ │
│ SessionStart: │ │ SessionStart: │
│ └── AgentOps injects prior knowledge │ │ └── AgentOps injects prior knowledge │
│ │ │ │
│ Execution: │ │ Execution: │
│ └── Claude-Flow orchestrates 60+ agents │ │ └── Claude-Flow orchestrates 60+ agents │
│ │ │ │
│ Validation: │ │ Validation: │
│ └── AgentOps /vibe validates all outputs │ │ └── AgentOps /vibe validates all outputs │
│ │ │ │
│ SessionEnd: │ │ SessionEnd: │
│ └── AgentOps extracts learnings for next time │ │ └── AgentOps extracts learnings for next time │
│ │ │ │
└─────────────────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────────────┘
``` ```
+17 -17
View File
@@ -75,31 +75,31 @@ GSD has persistence (state files, handoffs, threads) but no knowledge flywheel.
``` ```
┌─────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────┐
│ GSD │ │ GSD │
│ │ │ │
│ Session 1: discuss → plan → execute → verify → Done │ │ Session 1: discuss → plan → execute → verify → Done │
│ ↓ │ │ ↓ │
│ (state saved) │ │ (state saved) │
│ ↓ │ │ ↓ │
│ Session 2: resume-work → (same state, same intelligence) │ │ Session 2: resume-work → (same state, same intelligence) │
│ │ │ │
│ Session 100: (agents are no smarter than session 1) │ │ Session 100: (agents are no smarter than session 1) │
│ │ │ │
└─────────────────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────┐
│ AGENTOPS │ │ AGENTOPS │
│ │ │ │
│ Session 1: research → plan → pre-mortem → crank → vibe → retro│ │ Session 1: research → plan → pre-mortem → crank → vibe → retro │
│ ↓ │ │ ↓ │
│ (learnings extracted) │ │ (learnings extracted) │
│ ↓ │ │ ↓ │
│ (scored and stored) │ │ (scored and stored) │
│ │ │ │
│ Session 2: (inject prior knowledge) → better starting point │ │ Session 2: (inject prior knowledge) → better starting point │
│ │ │ │
│ Session 100: (agent is a domain expert with scored knowledge) │ │ Session 100: (agent is a domain expert with scored knowledge) │
│ │ │ │
└─────────────────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────────────┘
``` ```
+7 -7
View File
@@ -249,16 +249,16 @@ AgentOps doesn't aim for "spec-as-source" — it captures *learnings*, not just
│ └── Requirements → Design → Tasks (structured specs) │ │ └── Requirements → Design → Tasks (structured specs) │
│ │ │ │
│ AgentOps handles: │ │ AgentOps handles: │
│ └── Pre-mortem (failure simulation) │ │ └── Pre-mortem (failure simulation) │
│ └── /vibe (8-aspect validation) │ │ └── /vibe (8-aspect validation) │
│ └── /post-mortem (learning extraction) │ │ └── /post-mortem (learning extraction) │
│ └── Cross-session memory │ │ └── Cross-session memory │
│ │ │ │
│ Combined flow: │ │ Combined flow: │
│ SDD specs → AgentOps pre-mortem → Implement → AgentOps vibe │ │ SDD specs → AgentOps pre-mortem → Implement → AgentOps vibe │
│ ↓ │ │ ↓ │
│ Extract learnings │ │ Extract learnings │
│ ↓ │ │ ↓ │
│ Next session │ │ Next session │
└─────────────────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────────────┘
``` ```
+9 -9
View File
@@ -46,21 +46,21 @@ Built-in enforcement of software engineering best practices. No over-engineering
┌─────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────┐
│ SUPERPOWERS │ │ SUPERPOWERS │
│ │ │ │
│ Session 1: Debug auth bug [learned: token refresh] │ │ Session 1: Debug auth bug [learned: token refresh] │
│ Session 2: Debug auth bug [learned: token refresh] │ │ Session 2: Debug auth bug [learned: token refresh] │
│ Session 3: Debug auth bug [learned: token refresh] │ │ Session 3: Debug auth bug [learned: token refresh] │
│ ↑ │ │ ↑ │
│ Same learning, every time │ │ Same learning, every time │
└─────────────────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────┐
│ AGENTOPS │ │ AGENTOPS │
│ │ │ │
│ Session 1: Debug auth bug [learned: token refresh] │ │ Session 1: Debug auth bug [learned: token refresh] │
│ ↓ (stored) │ │ ↓ (stored) │
│ Session 2: Auth issue? "I remember this pattern" │ │ Session 2: Auth issue? "I remember this pattern" │
│ ↓ (reinforced) │ │ ↓ (reinforced) │
│ Session 3: Auth? *instant recall* │ │ Session 3: Auth? *instant recall* │
│ │ │ │
└─────────────────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────────────┘
``` ```
+5 -5
View File
@@ -18,15 +18,15 @@ The packet has five sections, each with a defined character budget, content sour
``` ```
┌──────────────────────────────────────────────────────────┐ ┌──────────────────────────────────────────────────────────┐
│ CONTEXT PACKET │ │ CONTEXT PACKET │
│ │ │ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ GOALS │ │ HISTORY │ │ INTEL │ │ │ │ GOALS │ │ HISTORY │ │ INTEL │ │
│ │ ~2K ch │ │ ~8K ch │ │ ~12K ch │ │ │ │ ~2K ch │ │ ~8K ch │ │ ~12K ch │ │
│ └─────────┘ └─────────┘ └─────────┘ │ │ └─────────┘ └─────────┘ └─────────┘ │
│ ┌─────────┐ ┌──────────┐ │ │ ┌─────────┐ ┌──────────┐ │
│ │ TASK │ │ PROTOCOL │ │ │ │ TASK │ │ PROTOCOL │ │
│ │ ~4K ch │ │ ~2K ch │ │ │ │ ~4K ch │ │ ~2K ch │ │
│ └─────────┘ └──────────┘ │ │ └─────────┘ └──────────┘ │
│ │ │ │
│ Total: ~28K chars / ~7K tokens │ │ Total: ~28K chars / ~7K tokens │
+16 -16
View File
@@ -486,42 +486,42 @@ The pipeline degrades gracefully. Each version is strictly better than the previ
Agent Session Agent Session
│ │
▼ ▼
┌─────────┐ ┌─────────┐ ┌──────────┐ ┌─────────┐
│ /forge │ │ /retro │ (existing skills, unchanged) │ /forge │ │ /retro │ (existing skills, unchanged)
└────┬─────┘ └────┬────┘ └────┬─────┘ └────┬────┘
│ │ │ │
▼ ▼ ▼ ▼
┌──────────────────────────┐ ┌──────────────────────────┐
│ STAGE 1: CATALOG │ v1 │ STAGE 1: CATALOG │ v1
│ Structure into typed │ │ Structure into typed │
│ artifacts with metadata │ │ artifacts with metadata │
│ → .agents/pool/pending/ │ │ → .agents/pool/pending/ │
└────────────┬─────────────┘ └────────────┬─────────────┘
│ │
▼ ▼
┌──────────────────────────┐ ┌──────────────────────────┐
│ STAGE 2: VERIFY │ v1 │ STAGE 2: VERIFY │ v1
│ Mechanical checks: │ │ Mechanical checks: │
│ tests pass? goals up? │ │ tests pass? goals up? │
│ → verification metadata │ │ → verification metadata │
└────────────┬─────────────┘ └────────────┬─────────────┘
│ │
▼ ▼
┌──────────────────────────┐ ┌──────────────────────────┐
│ STAGE 3: INDEX │ v2 │ STAGE 3: INDEX │ v2
│ Tag by topic, skill, │ │ Tag by topic, skill, │
│ goal. Update search idx │ │ goal. Update search idx │
│ → ao search, ao lookup │ │ → ao search, ao lookup │
└────────────┬─────────────┘ └────────────┬─────────────┘
│ │
▼ ▼
┌──────────────────────────┐ ┌──────────────────────────┐
│ STAGE 4: SCORE │ v2 │ STAGE 4: SCORE │ v2
│ 5-dim quality gate: │ │ 5-dim quality gate: │
│ specificity, action- │ │ specificity, action- │
│ ability, novelty, │ │ ability, novelty, │
│ context, confidence │ │ context, confidence │
│ → gold/silver/bronze │ │ → gold/silver/bronze │
└────────────┬─────────────┘ └────────────┬─────────────┘
│ │
┌────┴────┐ ┌────┴────┐
@@ -540,7 +540,7 @@ The pipeline degrades gracefully. Each version is strictly better than the previ
│ CONSTRAIN │ │ CONSTRAIN │
│ Compile into │ │ Compile into │
│ hook rules │ │ hook rules │
│ → constraints/│ │→ constraints/│
└──────────────┘ └──────────────┘
│ │
▼ ▼
+1 -1
View File
@@ -158,7 +158,7 @@ Multi-Session │ Olympus
│ │ │ │
│ ┌────┴────┐ │ ┌────┴────┐
│ │ AgentOps │ ← WE ARE HERE │ │ AgentOps │ ← WE ARE HERE
│ │(Shift-L) │ │ │(Shift-L)│
│ └────┬────┘ │ └────┬────┘
│ │ │ │
Single-Session │ Agent SDKs Single-Session │ Agent SDKs
+2 -2
View File
@@ -347,8 +347,8 @@ profile:
┌─────────────────────────────────────────┐ ┌─────────────────────────────────────────┐
│ Workspace Profiles (Production) │ ← Organize reality │ Workspace Profiles (Production) │ ← Organize reality
│ - 5 roles with 100+ real artifacts │ │ - 5 roles with 100+ real artifacts │
│ - Multi-repo coordination │ │ - Multi-repo coordination │
│ - Token budgets for composition │ │ - Token budgets for composition │
└─────────────────────────────────────────┘ └─────────────────────────────────────────┘
``` ```
+9 -9
View File
@@ -408,10 +408,10 @@ This is why progress can be made one-way at the artifact level, while system-lev
``` ```
┌─────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────┐
│ THE AGENTOPS SYSTEM │ │ THE AGENTOPS SYSTEM │
├─────────────────────────────────────────────────────────────────┤ ├─────────────────────────────────────────────────────────────────┤
│ │ │ │
│ DEVOPS LAYER (The Three Ways) │ │ DEVOPS LAYER (The Three Ways) │
│ ┌─────────────────────────────────────────────────────────┐ │ │ ┌─────────────────────────────────────────────────────────┐ │
│ │ Flow: Session → Forge → Store → Inject → Session │ │ │ │ Flow: Session → Forge → Store → Inject → Session │ │
│ │ Feedback: Vibe, Pre-mortem, Citations, Utility scores │ │ │ │ Feedback: Vibe, Pre-mortem, Citations, Utility scores │ │
@@ -445,13 +445,13 @@ This is why progress can be made one-way at the artifact level, while system-lev
│ ▼ │ │ ▼ │
│ THE GOAL (Escape Velocity) │ │ THE GOAL (Escape Velocity) │
│ ┌─────────────────────────────────────────────────────────┐ │ │ ┌─────────────────────────────────────────────────────────┐ │
│ │ │ │ │ │ │ │
│ │ σ × ρ > δ │ │ │ │ σ × ρ > δ │ │
│ │ │ │ │ │ │ │
│ │ retrieval × usage > decay │ │ │ │ retrieval × usage > decay │ │
│ │ │ │ │ │ │ │
│ │ When true: KNOWLEDGE COMPOUNDS │ │ │ │ When true: KNOWLEDGE COMPOUNDS │ │
│ │ │ │ │ │ │ │
│ └─────────────────────────────────────────────────────────┘ │ │ └─────────────────────────────────────────────────────────┘ │
│ │ │ │
└─────────────────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────────────┘
+11 -11
View File
@@ -72,7 +72,7 @@ with `ao codex ensure-stop`.
``` ```
┌─────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────┐
│ SESSION START │ │ SESSION START │
│ "Continue the API work" or /session-start │ │ "Continue the API work" or /session-start │
├─────────────────────────────────────────────────────────────┤ ├─────────────────────────────────────────────────────────────┤
│ • Load bundle (if exists) │ │ • Load bundle (if exists) │
@@ -83,22 +83,22 @@ with `ao codex ensure-stop`.
│ │
▼ ▼
┌─────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────┐
│ WORK │ │ WORK │
│ "Add the validation layer" or just start coding │ │ "Add the validation layer" or just start coding │
├─────────────────────────────────────────────────────────────┤ ├─────────────────────────────────────────────────────────────┤
│ • Implement features │ │ • Implement features │
│ • Fix bugs │ │ • Fix bugs │
│ • Research when needed │ │ • Research when needed │
│ • Commit frequently │ │ • Commit frequently │
│ │ │ │
│ Track progress: │ │ Track progress: │
│ • "Feature X is done" or /progress-update --complete X │ │ • "Feature X is done" or /progress-update --complete X │
│ • "I'm blocked on Y" or /progress-update --blocker "Y" │ │ • "I'm blocked on Y" or /progress-update --blocker "Y" │
└─────────────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────────┘
│ │
▼ ▼
┌─────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────┐
│ SESSION END │ │ SESSION END │
│ "Done for today" or /session-end │ │ "Done for today" or /session-end │
├─────────────────────────────────────────────────────────────┤ ├─────────────────────────────────────────────────────────────┤
│ • Check for uncommitted changes │ │ • Check for uncommitted changes │
@@ -113,7 +113,7 @@ with `ao codex ensure-stop`.
``` ```
┌─────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────┐
│ CODEX SESSION START │ │ CODEX SESSION START │
│ ao codex start │ │ ao codex start │
├─────────────────────────────────────────────────────────────┤ ├─────────────────────────────────────────────────────────────┤
│ • Inspect .agents/ and surfaced learnings │ │ • Inspect .agents/ and surfaced learnings │
@@ -134,7 +134,7 @@ with `ao codex ensure-stop`.
│ │
▼ ▼
┌─────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────┐
│ CODEX SESSION END │ │ CODEX SESSION END │
│ ao codex stop │ │ ao codex stop │
├─────────────────────────────────────────────────────────────┤ ├─────────────────────────────────────────────────────────────┤
│ • Resolve archived transcript or history fallback │ │ • Resolve archived transcript or history fallback │
+4 -4
View File
@@ -132,7 +132,7 @@ reads each judge's output file sequentially with the Read tool and synthesizes.
``` ```
┌─────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────┐
│ Phase 1: Build Packet (JSON) │ │ Phase 1: Build Packet (JSON) │
│ - Task type (validate/brainstorm/research) │ │ - Task type (validate/brainstorm/research) │
│ - Target description │ │ - Target description │
│ - Context (files, diffs, prior decisions) │ │ - Context (files, diffs, prior decisions) │
│ - Perspectives to assign │ │ - Perspectives to assign │
@@ -140,9 +140,9 @@ reads each judge's output file sequentially with the Read tool and synthesizes.
│ │
▼ ▼
┌─────────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────────┐
│ Phase 1a: Select spawn backend │ │ Phase 1a: Select spawn backend │
│ codex_subagents | claude_teams | background_fallback │ │ codex_subagents | claude_teams | background_fallback │
│ Team lead = spawner (this agent) │ │ Team lead = spawner (this agent) │
└─────────────────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────────────┘
│ │
┌─────────────────┴─────────────────┐ ┌─────────────────┴─────────────────┐
+4 -4
View File
@@ -10,12 +10,12 @@ FIRE is the reconciliation loop that extracts progress from chaos. Like a forge
``` ```
┌──────────────────────────────────────────────────────────┐ ┌──────────────────────────────────────────────────────────┐
│ FIRE LOOP │ │ FIRE LOOP │
│ │ │ │
│ FIND ────► IGNITE ────► REAP ────► ESCALATE │ │ FIND ────► IGNITE ────► REAP ────► ESCALATE │
│ (state) (chaos) (ratchet) (recovery) │ │ (state) (chaos) (ratchet) (recovery) │
│ │ │ │ │ │ │ │
│ └───────────────────────────────────┘ │ │ └───────────────────────────────────┘ │
│ (loop) │ │ (loop) │
│ │ │ │
│ EXIT when: all children closed │ │ EXIT when: all children closed │
+1 -1
View File
@@ -26,7 +26,7 @@ Pick what you need. Every skill works standalone. `/swarm` multiplies any of the
│ /implement ────► research + plan + build + vibe│ │ /implement ────► research + plan + build + vibe│
│ /vibe ─────────► /complexity + /council │ │ /vibe ─────────► /complexity + /council │
│ /pre-mortem ───► /council (failure simulation) │ │ /pre-mortem ───► /council (failure simulation) │
│ /post-mortem ──► /council + knowledge lifecycle │ │ /post-mortem ──► /council + knowledge lifecycle│
│ /council ──────► parallel judges (multi-model) │ │ /council ──────► parallel judges (multi-model) │
└─────────────────────────────────────────────────┘ └─────────────────────────────────────────────────┘
``` ```
+18 -18
View File
@@ -18,25 +18,25 @@
## Agent Autonomy Boundaries ## Agent Autonomy Boundaries
``` ```
┌─────────────────────────────────────────────────────┐ ┌───────────────────────────────────────────────────────┐
│ AGENT-AUTONOMOUS (L0–L3) │ │ AGENT-AUTONOMOUS (L0–L3) │
│ Agent writes tests AND implementation. │ │ Agent writes tests AND implementation. │
│ No human input needed for test design. │ │ No human input needed for test design. │
│ │ │ │
│ L0: Contract — from SPEC.md alone │ │ L0: Contract — from SPEC.md alone │
│ L1: Unit — TDD RED→GREEN from spec │ │ L1: Unit — TDD RED→GREEN from spec │
│ L2: Integration — from subsystem spec + adapters │ │ L2: Integration — from subsystem spec + adapters │
│ L3: Component — agent writes, human defines scenarios│ │ L3: Component — agent writes, human defines scenarios│
├─────────────────────────────────────────────────────┤ ├───────────────────────────────────────────────────────┤
│ HUMAN-GUIDED (L4–L7) │ │ HUMAN-GUIDED (L4–L7) │
│ Human defines WHAT to test. │ │ Human defines WHAT to test. │
│ Agent builds the test infrastructure. │ │ Agent builds the test infrastructure. │
│ │ │ │
│ L4: Smoke — human defines "critical path" │ │ L4: Smoke — human defines "critical path" │
│ L5: E2E — human designs flow, agent harness │ │ L5: E2E — human designs flow, agent harness │
│ L6: Acceptance— human only validates │ │ L6: Acceptance— human only validates │
│ L7: Prod — monitors + human judgment │ │ L7: Prod — monitors + human judgment │
└─────────────────────────────────────────────────────┘ └───────────────────────────────────────────────────────┘
``` ```
## RPI Phase Mapping ## RPI Phase Mapping
+4 -4
View File
@@ -175,10 +175,10 @@ File Ownership Map (Wave N):
┌─────────────────────────────┬──────────┬──────────┐ ┌─────────────────────────────┬──────────┬──────────┐
│ File │ Owner │ Conflict │ │ File │ Owner │ Conflict │
├─────────────────────────────┼──────────┼──────────┤ ├─────────────────────────────┼──────────┼──────────┤
│ src/auth/middleware.go │ task-1 │ │ │ src/auth/middleware.go │ task-1 │ │
│ src/auth/middleware_test.go │ task-1 │ │ │ src/auth/middleware_test.go │ task-1 │ │
│ src/api/routes.go │ task-2 │ │ │ src/api/routes.go │ task-2 │ │
│ src/config/settings.go │ task-1,3 │ YES │ │ src/config/settings.go │ task-1,3 │ YES │
└─────────────────────────────┴──────────┴──────────┘ └─────────────────────────────┴──────────┴──────────┘
Conflicts: 1 (resolved: serialized task-3 into sub-wave 2) Conflicts: 1 (resolved: serialized task-3 into sub-wave 2)
``` ```