feat(templates): add optional Business Context section to PROJECT.md template (#756)
* feat(templates): add optional Business Context section to PROJECT.md template Adds an optional `## Business Context` section (Customer, Revenue model, Success metric, Strategy notes) between Core Value and Requirements, for monetized or customer-facing projects. Optional by default — an HTML comment tells non-business projects to delete it; capped at four one-line fields to stay a constraint reference, not a business plan. The milestone evolution review in complete-milestone.md checks it only when the section is present. Refs #72 * chore(changeset): set pr number for #72 fragment * test(#72): add source-text-is-the-product exemption marker Addresses review Minor #1 on PR #756. The contract test reads the PROJECT.md template and complete-milestone workflow .md files and asserts on their content (the local/no-source-grep pattern). Those .md files ARE the product surface, so this is a valid source-text-is-the-product case. Add the explicit // allow-test-rule marker per RULESET.TESTS.no-source-grep.exemption so intent is audit-traceable before the rule promotes to error (#453). --------- Co-authored-by: Tom Boucher <trekkie@nomorestars.com>
This commit is contained in:
@@ -17,6 +17,15 @@ Use the user's language and framing. Update whenever reality drifts from this de
|
||||
[The ONE thing that matters most. If everything else fails, this must work.
|
||||
One sentence that drives prioritization when tradeoffs arise.]
|
||||
|
||||
## Business Context
|
||||
|
||||
<!-- OPTIONAL — only for monetized or customer-facing projects. Delete this section otherwise. -->
|
||||
|
||||
- **Customer**: [Who pays / who uses — one line]
|
||||
- **Revenue model**: [How it makes money — one line]
|
||||
- **Success metric**: [The number that matters — one line]
|
||||
- **Strategy notes**: [Link to external strategy doc, if any]
|
||||
|
||||
## Requirements
|
||||
|
||||
### Validated
|
||||
@@ -83,6 +92,13 @@ Common types: Tech stack, Timeline, Budget, Dependencies, Compatibility, Perform
|
||||
- Drives prioritization when tradeoffs arise
|
||||
- Rarely changes; if it does, it's a significant pivot
|
||||
|
||||
**Business Context:**
|
||||
- Optional — only for monetized or customer-facing projects
|
||||
- Delete the entire section for internal tools, experiments, or meta workspaces
|
||||
- 4 fields max, one line each — a constraint reference, not a business plan
|
||||
- Use **Strategy notes** to link out to a dedicated strategy doc rather than duplicating it here
|
||||
- Informs requirement prioritization: features serving the customer/revenue model come first
|
||||
|
||||
**Requirements — Validated:**
|
||||
- Requirements that shipped and proved valuable
|
||||
- Format: `- ✓ [Requirement] — [version/phase]`
|
||||
@@ -140,8 +156,9 @@ and implemented by workflows/transition.md and workflows/complete-milestone.md.
|
||||
**After each milestone:**
|
||||
1. Full review of all sections
|
||||
2. Core Value check — still the right priority?
|
||||
3. Audit Out of Scope — reasons still valid?
|
||||
4. Update Context with current state (users, feedback, metrics)
|
||||
3. Business Context check (if present) — customer, revenue model, success metric still accurate?
|
||||
4. Audit Out of Scope — reasons still valid?
|
||||
5. Update Context with current state (users, feedback, metrics)
|
||||
|
||||
</evolution>
|
||||
|
||||
|
||||
Reference in New Issue
Block a user