Guided Intelligence
§4 · The GI Flow

A single-threaded, domain-aligned pipeline.

The forward flow is the default. Backflow is allowed but tightly controlled. Parallelization is discouraged by design. GI is depth-first, not breadth-first.

§4.1 · The forward flow

Intent in, production out, continuously.

PLANNER Execution Plan Scope · invariants BUILDER AI Execution Code · tests · diffs REVIEWER Semantic Gate Intent · invariants DEPLOY Ring 0 → Ring 1 Canary deploy PAT Continuous Async validation INTENT → continuous, single-threaded forward flow → PRODUCTION
Stage 1

Planner → Builder

The Planner produces the Execution Plan: scope, constraints, invariants, integration surfaces, and risk notes. Once approved, the Builder begins execution.

Rules
  1. 1.Nothing starts until the plan is approved.
  2. 2.Builders work on exactly one Execution Plan at a time.
  3. 3.Context switching is treated as a cost, not a tactic.
Stage 2

Builder → Reviewer

The Builder uses AI to execute the plan: code, tests, migrations, refactors, and invariant validation. They keep AI aligned and correct missteps early.

Rules
  1. 1.Builder verifies all mechanical correctness before review.
  2. 2.Reviewer time is sacred: only semantic questions reach them.
  3. 3.Small, clean, focused diffs are mandatory.
Stage 3

Reviewer → Merge

The Reviewer checks intent alignment, invariant preservation, architectural correctness, domain boundary respect, and semantic coherence. If approved, the change merges and deploys to Ring 0 then Ring 1 automatically.

Rules
  1. 1.Reviewer is the final semantic authority.
  2. 2.Reviewer speed determines domain throughput.
  3. 3.Reviewer rejects are treated as high-priority events.
§4.2 · Reviewer as regulator

Reviewers give GI its structural coherence.

Their decisions control whether work proceeds, whether backflow occurs, whether the domain stops, and whether the system stays coherent.

1
Time is the scarcest resource

Domain throughput depends on review capacity.

2
Feedback stays semantic

No nitpicking syntax or style. AI handles that upstream.

3
Rejects are system events

A reject signals semantic drift or a planning defect, not a typo.

4
Authority is unambiguous

No democratic review. No multiple approvals. One Reviewer is enough.

§4.3 · Backflow

Three strict paths when forward flow breaks.

Each path has rules designed to minimize chaos and keep the pipeline depth-first.

Path A Backflow

Standard Reject

Reviewer → Builder
REVIEWER BUILDER
When

Output does not match the plan; invariants violated; semantics incorrect; diff too unfocused.

Rule

Local and fast. Builder fixes immediately; no parallel tasks.

Path B Backflow

Plan Rejection

Reviewer → Planner → Builder
REVIEWER PLANNER BUILDER
When

Planner misunderstood intent; direction is wrong even though output matches the plan.

Rule

Planner revises the plan incrementally; Builder resumes execution.

Path C Backflow

Builder Blocked

Builder → Planner
BUILDER PLANNER
When

Plan is ambiguous, contract missing, dependency unknown, domain rule unclear.

Rule

Cheapest backflow when caught early. Builder stops; Planner clarifies in minutes/hours.

§4.4 · Blockers

Four blocker types. Four resolution paths.

Type
Resolver
Description
Domain Internal
Planner
Resolved within the domain by the Planner.
Cross-Domain Contract
Planner ↔ Planner
Resolved between the respective domain Planners.
AI Execution Limitation
Builder or Planner
Mitigated by Builder; escalated when constraints need to change.
Sev5 System Blocker
Stop the line
Halts the entire domain until invariants are restored.
§4.5 · Parallelization

Builders work one plan at a time. Planners focus on one semantic framing at a time. Reviewers handle one review at a time. Backflow is resolved before new forward work begins.

Parallelization under AI acceleration creates thrash, ambiguity, and compounding semantic errors. GI is depth-first by design.