Skip to content

refactor(docs): migrate MVP specs to spec-driven structure - #113

Merged
JLaborda merged 5 commits into
developfrom
refactor/spec-driven-structure
Jul 1, 2026
Merged

refactor(docs): migrate MVP specs to spec-driven structure#113
JLaborda merged 5 commits into
developfrom
refactor/spec-driven-structure

Conversation

@JLaborda

@JLaborda JLaborda commented Jul 1, 2026

Copy link
Copy Markdown
Owner

Summary

  • Move all MVP documentation from docs/mvp/ and docs/adr/ to a spec/ tree: constitution/ (mission, tech-stack, roadmap), numbered features/00N-slug/spec.md, ADRs, guides, PRDs, and meta workflow docs.
  • Replace Notion task tracking with GitHub Issues workflow (spec/meta/github-issues.md, .cursor/rules/github-issues.mdc).
  • Add spec/meta/feature-spec-template.md for new features (Delivery + In scope / Out of scope).
  • Update agent rules, AGENTS.md, CONTEXT.md, and source docstring paths to point at spec/.
  • Fix .gitignore so spec/features/*portfolio*/ is not blocked by *portfolio*.

Test plan

  • make lint passes
  • make test — 228 passed
  • Review spec/README.md index and feature numbering
  • Confirm GitHub Issues workflow matches how you track work today

Made with Cursor

JLaborda and others added 5 commits July 1, 2026 07:52
Move MVP documentation under spec/ with constitution, numbered features,
ADRs, guides, and GitHub Issues workflow. Add feature spec template.

Co-authored-by: Cursor <cursoragent@cursor.com>
Replace Notion task tracking with GitHub Issues workflow and update
all agent path references from docs/mvp to spec/.

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Un-ignore spec/features/*portfolio*/ paths blocked by *portfolio* gitignore.

Co-authored-by: Cursor <cursoragent@cursor.com>
Use Delivery + In scope / Out of scope instead of MVP-prefixed headings.

Co-authored-by: Cursor <cursoragent@cursor.com>
@codecov

codecov Bot commented Jul 1, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.87%. Comparing base (8be0dea) to head (e80acff).

Additional details and impacted files
@@           Coverage Diff            @@
##           develop     #113   +/-   ##
========================================
  Coverage    97.87%   97.87%           
========================================
  Files           23       23           
  Lines         1552     1552           
  Branches       192      192           
========================================
  Hits          1519     1519           
  Misses          25       25           
  Partials         8        8           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@JLaborda
JLaborda merged commit 58811d2 into develop Jul 1, 2026
4 checks passed
@JLaborda
JLaborda deleted the refactor/spec-driven-structure branch July 1, 2026 08:04
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