Task

Execute a single atomic content unit using Preview-First Development.

Atomic Unit Reference

Golden Rule: If you can't describe the unit in one sentence, it's too big.

Breaking Down Pages

A full page is NOT atomic. Break it down:

Example: about.qmd (CV page)

❌ BAD:  "Create about.qmd" (too big)

✓ GOOD: Break into atomic tasks:
  1. Create about.qmd with YAML front matter + intro
  2. Add Education section
  3. Add Professional Experience section
  4. Add Technical Skills section
  5. Add Research Interests section

Example: index.qmd (Landing page)

❌ BAD:  "Create landing page" (too big)

✓ GOOD: Break into atomic tasks:
  1. Create index.qmd with hero headline + tagline
  2. Add brief bio paragraph
  3. Add skills highlights grid
  4. Add featured projects links
  5. Add call-to-action (contact/CV download)

Pre-Execution Validation

Step 1: Verify Task is in Plan

Read brain/plan.md
└── Find task matching description
    ├── Found → Continue
    └── Not Found → STOP
        ⚠️ TASK NOT IN PLAN
        Options:
        [A] Run /plan to add this task (requires approval)
        [B] Modify task to match existing plan
        [C] Abort

Step 2: Verify Atomic Scope

Task must be describable in ONE sentence:

• •"Add Education section to about.qmd"
• •"Configure navbar with Home and About links"
• •"Add profile photo to assets"

If task needs multiple sentences → STOP → suggest /plan to decompose.

Step 3: Pre-Implementation Checklist

• • Target file path identified
• • Section/component purpose clear
• • Content scope limited (one logical unit)
• • Dependencies identified (does it need assets? other sections?)

Execution Protocol (Preview-First)

Phase 1: Start Preview

# Start Quarto preview if not running
quarto preview

Phase 2: Implement Content

Create/edit the atomic unit following brain/development_standard.md:

• •Keep scope tight (one section, one component)
• •Include proper formatting
• •Add images with alt text if needed

Phase 3: Verify in Preview

Check the live preview:

• • Section renders without errors
• • Content displays correctly
• • Any links work
• • Images display (if applicable)

Phase 4: Refactor (if needed)

• •Improve clarity
• •Ensure standards compliance
• •Re-check preview

Post-Execution Sequence

1. •Update plan.md — Mark task complete
2. •Run /update-brain — Sync codebase_index.md
3. •Run /commit — Create atomic commit

Output Format

═══════════════════════════════════════════════════════
  TASK COMPLETE
═══════════════════════════════════════════════════════

Task: Add Education section to about.qmd
Unit: Section (~25 lines)
File: about.qmd

Preview: ✓ Renders correctly

Progress: [N/M] tasks complete

Sequential Execution Logic

After completing a task, check brain/plan.md:

Pending tasks remaining?
├── YES → Automatically proceed to next task
└── NO  → All tasks complete
          Output: "Session tasks complete. Run /session-end to finalize."

Stop conditions:

• •All planned tasks complete → suggest /session-end
• •Render error that can't be resolved → ask human
• •Task not in plan → ask human
• •Task scope creep detected → ask human

Failure Handling

Task Too Complex

1. •STOP implementation
2. •Inform human: "Task requires decomposition"
3. •Suggest breaking into smaller units:
   • •Identify logical sections
   • •Each section = 1 task

Scope Creep Detection

If while implementing you realize you need to:

• •Edit multiple files
• •Add multiple sections
• •Create dependencies not in plan

→ STOP and ask human if scope should expand or task should split.

Commands Reference

# Preview
quarto preview                 # Start live preview
quarto preview page.qmd        # Preview specific page

# Render
quarto render page.qmd         # Render specific page

# Clean (if issues)
rm -rf _site/ .quarto/ *_files/