Skip to content

feat(harness): sprint tracking convention + README overhaul - #3

Merged
rdemeritt merged 1 commit into
mainfrom
feat/sprint-convention
Jun 5, 2026
Merged

rdemeritt merged 1 commit into
mainfrom
feat/sprint-convention

Conversation

@rdemeritt

Copy link
Copy Markdown
Member

Summary

Two coordinated changes on one branch.

Sprint tracking (per-project)

  • New per-project sprints/ directory under each clients/<slug>/projects/<slug>/
  • CURRENT symlink always points at the active sprint file
  • templates/sprint-plan.md extended with frontmatter (status, dates, goal), milestone grouping, PR-links column, and an embedded retrospective section
  • /sprint-plan rewritten: auto-detects next sprint number, writes to sprints/sprint-NNN.md (fixes prior bug writing to specs/), repoints CURRENT
  • /retro rewritten: reads CURRENT, stamps closed_date + status: closed, writes retro into the same sprint file (no separate retro doc)
  • CLAUDE.md updated under Multi-Client Governance

README overhaul

  • Badges, What It Is, How It Works with Mermaid pipeline flow
  • Full 25-agent team roster table including Hardware Council
  • Mermaid team hierarchy and sprint git-flow diagrams
  • Directory structure, getting started, key commands
  • The six non-negotiable workflow gates explained
  • Sprint tracking convention documented
  • scripts/sync-to-public.sh usage and PII guard documented
  • Contributing guidelines

Test plan

  • PII guard CI passes (no /Users/, clients/self, or rdemeritt references slip through)
  • Render README on GitHub and confirm Mermaid diagrams display correctly
  • Manually run /sprint-plan against a test project and confirm sprints/sprint-001.md is created and CURRENT symlink is correct
  • Manually run /retro and confirm the active sprint flips to status: closed with closed_date stamped and retro filled

Sprint tracking (per-project):
- Add sprints/ directory convention with CURRENT symlink per project
- Extend templates/sprint-plan.md: frontmatter (status, dates, goal),
  milestone grouping, PR-links column, in-file retrospective section
- Rewrite /sprint-plan: auto-detect next sprint number, write to
  sprints/sprint-NNN.md (fixes prior bug writing to specs/), repoint CURRENT
- Rewrite /retro: read CURRENT, stamp closed_date + status: closed,
  write retro into same sprint file (no separate retro-*.md)
- Document convention in CLAUDE.md under Multi-Client Governance

README overhaul:
- Add badges, What It Is, How It Works with Mermaid pipeline flow
- Add full 25-agent team roster table with Hardware Council
- Add Mermaid team hierarchy and sprint git-flow diagrams
- Document directory structure, getting started, key commands
- Explain the six non-negotiable workflow gates
- Document sprint tracking convention
- Document scripts/sync-to-public.sh usage and PII guard
- Add contributing guidelines
@rdemeritt
rdemeritt merged commit d55480d into main Jun 5, 2026
1 check passed
@rdemeritt
rdemeritt deleted the feat/sprint-convention branch June 5, 2026 18:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant