Skip to content

docs(forgeplan): PRD-010 + RFC-009 + PRD-011 + RFC-010 + NOTE-001#54

Merged
explosivebit merged 2 commits into
developfrom
docs/f22-f23-artifacts
May 6, 2026
Merged

docs(forgeplan): PRD-010 + RFC-009 + PRD-011 + RFC-010 + NOTE-001#54
explosivebit merged 2 commits into
developfrom
docs/f22-f23-artifacts

Conversation

@explosivebit
Copy link
Copy Markdown
Contributor

Summary

5 artifacts seeding the next strategic features after F18/F19.

F22 — Workspace pulse (PRD-010 + RFC-009)

Stats dashboard with 4 charts (R_eff histogram, decay calendar, weekly velocity, status transitions Sankey) + 0..100 health score with 30-day sparkline.
Critical UX constraint: every chart MUST ship with hover tooltip + static caption + 🟢/🟡/🔴 plain-language interpretation badge.

F23 — Proactive hints engine (PRD-011 + RFC-010)

Top-3 hints panel above HealthBar; 8 initial rules covering forgeplan anomalies; severity × recency ranking; snooze 1d/1w with TTL auto-cleanup.

NOTE-001 — Backlog

12 deferred ideas (F25-F36) with cost estimates and "do/skip/wait" criteria. Includes "Ask AI" light, RSS feed, permalink, inline search, walkthrough, GitHub cross-link, annotation layer, embedded-chat (heavy — separate product).

Linked properly via forgeplan link

  • RFC-009 -refines→ PRD-010
  • RFC-010 -refines→ PRD-011
  • PRD-008 -informs→ PRD-010 (time-travel feeds pulse data)
  • PRD-010 -informs→ PRD-011 (stats metrics feed hints)
  • NOTE-001 -informs→ PRD-008/009/010/011

forgeplan reindex: 70 synced, 0 errors. forgeplan health: green.

Verify

  • forgeplan reindex clean.
  • forgeplan validate: all PASS (PRD-010/011 with non-blocking orphan-FR warnings; RFCs/Note clean).
  • forgeplan graph shows 8 new edges.

🤖 Generated with Claude Code

PRD-010 (Standard) — Workspace pulse: stats dashboard + health
score + trends. 4 charts (R_eff histogram, decay calendar, weekly
velocity, status transitions Sankey) + 0..100 health score with
30-day sparkline. CRITICAL UX constraint: every chart MUST ship
with hover tooltip + static caption + plain-language interpretation
badge. SC-1..SC-10 + 15 FRs.

RFC-009 (Standard) — Stats dashboard charts + plain-language
interpretation. Pins exact chart shapes, axis math, colour mapping;
heuristic 🟢/🟡/🔴 thresholds per chart with copy templates;
median-based health score formula resistant to single-artifact
gaming. /api/pulse endpoint contract. 8 implementation phases F22-T1..T8.

PRD-011 (Standard) — Proactive hints engine for workspace anomalies.
Top-3 hints panel above HealthBar; 8+ rules covering common
forgeplan-anomalies; severity × recency ranking; snooze 1d/1w with
TTL auto-cleanup. SC-1..SC-10 + 12 FRs.

RFC-010 (Standard) — Hints rule DSL + ranking dispatcher. Pins
HintRule shape (single-file extension point), 8 initial rules with
trigger + copy templates, ranking algorithm, snooze model,
localization-ready copy map. 7 implementation phases F23-T1..T7.

NOTE-001 (Tactical) — Web utilities backlog. Captures 12 deferred
ideas (F25-F36): "Ask AI" light, RSS feed, view-state permalink,
inline structured search, walkthrough mode, GitHub PR cross-link,
decision genealogy, snapshot bookmarks, annotation layer, embedded
chat (heavy — separate product), coverage section, onboarding hint.
Decision criteria + which-not-to-do.

All 5 linked via `forgeplan link`:
- RFC-009 -refines-> PRD-010, RFC-010 -refines-> PRD-011
- PRD-008 -informs-> PRD-010 (time-travel feeds pulse)
- PRD-010 -informs-> PRD-011 (stats feeds hints)
- NOTE-001 -informs-> PRD-008/009/010/011

Reindex: 70 synced, 0 errors. forgeplan health: green.

Refs: PRD-010 RFC-009 PRD-011 RFC-010 NOTE-001
forgeplan link wrote `links:` arrays into frontmatter of the
already-merged F18/F19 artifacts when establishing the cross-feature
relations:
- PRD-008 -informs-> PRD-010 (time-travel feeds pulse data)
- PRD-009 (received NOTE-001 -informs-> PRD-009)
- RFC-007 / RFC-008 received NOTE-001 -informs-> them

These are pure metadata updates (Lance index already had the edges
from the F18/F19 merge; this just syncs markdown frontmatter).

Refs: PRD-008 PRD-009 RFC-007 RFC-008
@explosivebit explosivebit merged commit 2202517 into develop May 6, 2026
3 checks passed
@explosivebit explosivebit deleted the docs/f22-f23-artifacts branch May 6, 2026 12:24
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