gh issue create \
  --title "Feature: {Feature Name}" \
  --body "$(cat <<'EOF'
## Overview
{Brief description from INDEX}

## Documentation
- INDEX: [docs/system/INDEX-{feature}.md]
- Design docs: Listed in INDEX

## Phases
- [ ] Phase 1.1: {Phase name}
- [ ] Phase 1.2: {Phase name}
- [ ] Phase 1.3: {Phase name}

## Branch
`feature/desk-{feature-name}`

---
🤖 Created by {agent-name}
EOF
)"

gh issue comment {issue-number} --body "🔨 **Phase {X.Y} Started**: {Phase name}

**Agent**: {agent-name}
**Status**: Starting implementation
**Progress**: 0%

**Tasks in this phase**:
1. {Task 1}
2. {Task 2}
3. {Task 3}

See execution log: docs/system/execution/phase{X.Y}-{topic}.md"

gh issue comment {issue-number} --body "📊 **Phase {X.Y} Progress Update**

**Agent**: {agent-name}

## Completed Tasks
- ✅ Task {N}: {Task name}
  - Implementation: {brief description}
  - Tests: {N} tests created/passing
  - Files: {list key files created/modified}
  - Verification: Build ✅, Tests ✅

## In Progress
- 🚧 Task {N+1}: {Task name}
  - Status: {specific status}
  - Blockers: {none or list}

## Next Steps
- ⏭️ Task {N+2}: {Task name}

## Test Summary
- Total tests: {N} ({X} passing, {Y} pending)
- All active tests passing: ✅ {N}/{N}
- Coverage: {key scenarios}

## Verification Evidence
\`\`\`bash
# Most recent verification
$ npm run build && npm run lint && npm test
{paste actual output}
\`\`\`

**Progress**: {percentage}% ({N} of {M} tasks complete)

See detailed log: docs/system/execution/phase{X.Y}-{topic}.md"

gh issue comment {issue-number} --body "🧪 **TDD Checkpoint - Phase {X.Y}**

**Agent**: {agent-name}
**Feature**: {Feature being tested}

## Red Phase
- ✅ Created failing test for {feature}
- Test file: \`{test-file-path}\`
- Expected behavior: {description}

## Status
- Test is watching for implementation
- Next: Write minimal code to make test pass (Green phase)

See execution log: docs/system/execution/phase{X.Y}-{topic}.md"

# Step 1: Commit screenshots to repository FIRST
mkdir -p screenshots/phase-{X.Y}
cp ./test-results/screenshots/*.png screenshots/phase-{X.Y}/
git add screenshots/phase-{X.Y}/
git commit -m "test: add E2E screenshots for Phase {X.Y}"
git push

# Step 2: Post update with embedded images
gh issue comment {issue-number} --body "✅ **E2E Tests Passed - Phase {X.Y}**

**Agent**: {agent-name}

## Test Results
- ✅ All {N} tests passing
- Test file: \`tests/{test-file}.spec.js\`
- Duration: {duration}
- Coverage: {scenarios}

## Test Execution Output
\`\`\`
{paste actual npx playwright test output}
\`\`\`

## Screenshots

### {Scenario 1}
![{description}](https://raw.githubusercontent.com/{owner}/{repo}/{branch}/screenshots/phase-{X.Y}/{screenshot1}.png)

### {Scenario 2}
![{description}](https://raw.githubusercontent.com/{owner}/{repo}/{branch}/screenshots/phase-{X.Y}/{screenshot2}.png)

## Verification Evidence
- Build: exit 0 ✅
- Tests: {N}/{N} passed ✅

See full test report: docs/system/execution/phase{X.Y}-{topic}.md"

gh issue comment {issue-number} --body "✅ **Phase {X.Y} Complete**

**Agent**: {agent-name}

## Verification
- [x] All tests passing ({N}/{N})
- [x] Build succeeds
- [x] Linting clean
- [x] E2E tests with screenshots posted
- [x] Documentation updated

**Progress**: 100% of Phase {X.Y}
**Overall Feature Progress**: {percentage}%

**Next**: {Next phase description or PR creation}

Updated: docs/system/execution/phase{X.Y}-{topic}.md"

# Run verification commands (MANDATORY)
npm run build  # Must exit 0
npm run lint   # Must show 0 errors
npm test       # All tests passing (or npx playwright test for E2E)

# Verify screenshots uploaded (for test tasks)
ls screenshots/phase-{X.Y}/  # Should show all screenshots

gh issue comment {issue-number} --body "🎉 **All Phases Complete**

**Agent**: {agent-name}

## Final Verification
- [x] All tests passing ({N}/{N})
- [x] Build succeeds
- [x] Linting clean
- [x] E2E tests complete with screenshots
- [x] Documentation updated
- [x] As-built documentation generated

**All task updates recorded**: {N}/{N}
"

gh issue close {issue-number} --comment "✅ **Feature Completed**

**Agent**: {agent-name}
## Post-Merge Activities
- [x] As-built documentation generated
- [x] User-facing docs updated
-- [x] INDEX status set to 'merged'

## Final Stats
- Phases completed: {N}/{N}
-- Task updates recorded: {N}
- Tests added: {N}
- Files changed: {N}

**As-built doc**: [docs/system/as-builts/{feature}-as-built.md]

Feature complete! 🎉"

gh issue comment 123 --body "📊 **Phase 1.2 Progress Update**

**Agent**: react-mui-frontend-engineer

## Completed Tasks
- ✅ Task 1: Created LeadsList component
...
"

---
github_issue: "#123"
feature_branch: "feature/desk-crm-leads"
pr_number: "#456"  # Filled after PR created
---

// Example: Read INDEX to get github_issue field
const indexPath = 'docs/system/INDEX-feature-name.md';
// Parse frontmatter to extract github_issue value
// Use that value in gh commands

See detailed log: docs/system/execution/phase{X.Y}-{topic}.md

Feature Start:
  1. Create GitHub issue (with agent ID)
  2. Create feature branch
  3. Update INDEX with issue number
  4. Post kickoff comment

During Execution:
  1. Post phase start comment (with agent ID)
  2. Post task completion updates (with agent ID)
  3. Post TDD checkpoints (with agent ID)
  4. Post Playwright results with screenshots (with agent ID)
  5. Create PR after EVERY task (with agent ID)
  6. Link PR to issue with comment (with agent ID)
  7. Post merge confirmation (with agent ID)
  8. Repeat for each task

Feature Completion:
  1. Post final verification to issue (with agent ID)
  2. Close issue with summary (with agent ID)
  3. Generate as-built documentation
  4. Delete feature branch