mosaicstack/stack
1
0
Fork 0
Code Issues 31 Pull Requests 2 Actions Packages Projects Releases 15 Wiki Activity

Spend-accounting template standard: PRDs/missions/task-decomposition carry PROJECTED + ACTUAL token spend #622

New Issue
Open
opened 2026-06-22 17:54:40 +00:00 by jason.woltje · 1 comment
jason.woltje commented 2026-06-22 17:54:40 +00:00
Owner
Copy Link

Source: Jason fleet doctrine 2026-06-22 (spend-accounting process mandate, half a).

Beyond docs/fleet/ — this is an aiguide + framework TEMPLATE standard: PRD, mission-manifest, and task-decomposition templates MUST carry a projected-token-spend and actual-token-spend field. Data used locally for budgeting/self-correction (see Fleet budget governance) and fed to the telemetry feature (separate issue).

Scope: aiguide template docs + framework PRD/mission/TASKS templates. Post-MVP; tracked so it is not conflated with the Fleet PoC doc PR. Not started.

Source: Jason fleet doctrine 2026-06-22 (spend-accounting process mandate, half a). Beyond docs/fleet/ — this is an aiguide + framework TEMPLATE standard: PRD, mission-manifest, and task-decomposition templates MUST carry a projected-token-spend and actual-token-spend field. Data used locally for budgeting/self-correction (see Fleet budget governance) and fed to the telemetry feature (separate issue). Scope: aiguide template docs + framework PRD/mission/TASKS templates. Post-MVP; tracked so it is not conflated with the Fleet PoC doc PR. Not started.
jason.woltje commented 2026-06-22 17:59:32 +00:00
Author
Owner
Copy Link

RECON (delegated, per Jason 2026-06-22): the PRD/mission/task templates ALREADY exist in the framework at packages/mosaic/framework/templates/docs/ (replicated to ~/.config/mosaic/templates/ on install). Spend tracking is PARTIALLY present already:

  • MISSION-MANIFEST.md.template: ALREADY has a 'Token Budget' section (Budget / Used / Mode). No new field needed; verify it is populated at mission init.
  • TASKS.md.template: ALREADY has estimate + used columns. Clarify these are TOKENS (optionally rename projected_tokens / actual_tokens) + add guidance.
  • PRD.md.template: NO token field — add an 'Estimated Token Budget' section after 'Milestone / Delivery Intent'. PRDY tool (~/.config/mosaic/tools/prdy/, esp. prdy-validate.sh) may need to require it.

REVISED SCOPE: EXTEND IN-PLACE, do NOT create new templates. Exact files: packages/mosaic/framework/templates/docs/{PRD,MISSION-MANIFEST,TASKS}.md.template. Much smaller than greenfield. Behavioral half: our live mission docs should actually POPULATE the existing Token Budget / estimate+used fields (part of adopting the spend-accounting doctrine).

RECON (delegated, per Jason 2026-06-22): the PRD/mission/task templates ALREADY exist in the framework at packages/mosaic/framework/templates/docs/ (replicated to ~/.config/mosaic/templates/ on install). Spend tracking is PARTIALLY present already: - MISSION-MANIFEST.md.template: ALREADY has a 'Token Budget' section (Budget / Used / Mode). No new field needed; verify it is populated at mission init. - TASKS.md.template: ALREADY has estimate + used columns. Clarify these are TOKENS (optionally rename projected_tokens / actual_tokens) + add guidance. - PRD.md.template: NO token field — add an 'Estimated Token Budget' section after 'Milestone / Delivery Intent'. PRDY tool (~/.config/mosaic/tools/prdy/, esp. prdy-validate.sh) may need to require it. REVISED SCOPE: EXTEND IN-PLACE, do NOT create new templates. Exact files: packages/mosaic/framework/templates/docs/{PRD,MISSION-MANIFEST,TASKS}.md.template. Much smaller than greenfield. Behavioral half: our live mission docs should actually POPULATE the existing Token Budget / estimate+used fields (part of adopting the spend-accounting doctrine).
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
fleet-enhancement
Fleet-wide reliability/speed/cost improvements surfaced by the nightly enhance pass
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
jason.woltje
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mosaicstack/stack#622
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?