Intent Build Now

Start building from Intent. Validates completeness, then chooses execution path.

Workflow

code

/intent-build-now [path]
       ↓
Locate Intent + plan.md
       ↓
Validate completeness ──→ Incomplete? ──→ Show gaps, suggest /intent-plan
       ↓
Check for TaskSwarm
       │
       ├── Has TaskSwarm + TASK.yaml ──→ Delegate to /swarm run
       │
       └── No TaskSwarm ──→ Execute TDD phases directly

Step 1: Locate Files

Search for Intent files in order:

•User-specified path
•intent/{name}/ directories
•Current directory

Required files:

•INTENT.md - The intent document
•plan.md - Execution plan with test matrix

Optional:

•TASK.yaml - TaskSwarm status file

If plan.md missing:

code

plan.md not found.

Run /intent-plan first to generate the execution plan.

Step 2: Validate Intent Completeness

Required Sections in INTENT.md

Section	Purpose	How to Fix
Responsibilities	What it does / doesn't do	Use `/intent-interview` to clarify scope
Structure	ASCII diagram of components	Add `## Structure` with ASCII diagram
API	Function signatures	Define key interfaces in `## API`

Required in plan.md

Check	Criteria
Phases	Has `## Phase 0:` or more phases
Tests	Each phase has 6 test categories
E2E Gate	Each phase has `### E2E Gate`
Checkboxes	Uses `- [ ]` format

If Not Ready

markdown

## Intent Validation: NEEDS WORK

Missing elements:

1. **plan.md missing E2E Gate for Phase 1**
   - Add `### E2E Gate` with verification script

2. **plan.md Phase 0 missing Data Leak tests**
   - Add `#### Data Leak` section with test cases

Run /intent-plan to regenerate, or fix manually.

Step 3: Choose Execution Path

Path A: TaskSwarm Available

Detect TaskSwarm by checking:

•TASK.yaml exists in intent directory
•TaskSwarm plugin is installed (check for /swarm skill)

If both conditions met:

markdown

## Intent Validation: PASSED ✓

TaskSwarm detected. Delegating execution...

Your Intent is ready. Run:

    /swarm run {task_name}

Or for continuous execution:

    /swarm run-all

TaskSwarm will:
- Claim the task atomically
- Execute phases with TDD discipline
- Update checkboxes in plan.md
- Commit after each phase
- Push to remote

Do NOT execute phases yourself when TaskSwarm is available.

Path B: No TaskSwarm (Direct Execution)

If TaskSwarm not available:

markdown

## Intent Validation: PASSED ✓

No TaskSwarm detected. Executing directly...

Starting Phase 0: {phase_name}

Then execute TDD loop for each phase:

code

For each Phase:
  1. Read ### Tests section
  2. For each unchecked test `- [ ]`:
     a. Write test code (if not exists)
     b. Run test → expect failure (red)
     c. Write implementation
     d. Run test → expect pass (green)
     e. Update plan.md: `- [ ]` → `- [x]`
  3. Run E2E Gate script
  4. Git commit: "feat({scope}): Phase {n} - {phase_name}"
  5. Continue to next Phase

Step 4: Completion

After all phases complete:

markdown

## Build Complete ✓

All phases executed:
- Phase 0: {name} ✓
- Phase 1: {name} ✓

Next steps:
- Run /intent-sync to update Intent with confirmed details
- Run /intent-check to verify consistency

Integration

code

/intent-interview     # Create Intent from scratch
    ↓
/intent-review        # Section-by-section approval
    ↓
/intent-plan          # Generate plan.md + TASK.yaml
    ↓
/intent-build-now     # THIS SKILL
    ↓
┌───────────────────────────────────────┐
│  Has TaskSwarm?                       │
│    Yes → /swarm run (delegate)        │
│    No  → Execute TDD directly         │
└───────────────────────────────────────┘
    ↓
/intent-sync          # Sync confirmed details back

TDD Execution Standards (Direct Mode)

When executing without TaskSwarm, follow strict TDD:

Test Categories (All 6 Required)

•Happy Path - Normal expected usage
•Bad Path - Invalid inputs, error conditions
•Edge Cases - Boundary conditions
•Security - Vulnerability prevention
•Data Leak - Information exposure prevention
•Data Damage - Data integrity protection

TDD Discipline

•Tests First: Write ALL tests before implementation
•Red-Green-Refactor: Verify test fails, implement, verify pass
•No Skip: Every checkbox must be completed
•Commit Per Phase: One commit after each phase passes

E2E Gate Enforcement

Each phase's E2E Gate script MUST pass before proceeding:

bash

# Run the E2E Gate script from plan.md
# Example: pnpm test -- --grep "Phase 0"

# If fails: Stop and fix
# If passes: Continue to next phase

Tips

•Prefer TaskSwarm - It handles concurrency, heartbeat, and recovery
•Don't force incomplete Intents - Missing plan.md means not ready
•Respect checkboxes - They're the source of truth for progress
•Commit frequently - One commit per phase, not one mega-commit