Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 21 additions & 6 deletions Sources/SpecGraph/Documentation.docc/ProductWorkspacePilots.md
Original file line number Diff line number Diff line change
Expand Up @@ -360,9 +360,10 @@ The follow-up backlog from that smoke is:
candidates as a live product story; done in proposal `0204` with
`make real-idea-smoke-depth-baseline` and `product_demo_depth_report.json`;
11. add human-friendly display aliases for long generated candidate node ids;
12. allow custom run-dir repaired candidates to continue into Platform
approval/promotion dry-run without copying artifacts into canonical
`runs/*.json`.
12. reconcile custom run-dir repaired candidates with the existing Platform
arbitrary-route approval/promotion dry-run path, then either document that
path as sufficient or add a small producer handoff that avoids copying
artifacts into canonical `runs/*.json`.

Proposal `0201` adds the public-safe candidate overview producer:

Expand Down Expand Up @@ -728,9 +729,23 @@ dimensions, and whether the repair effect was `improved`, `resolved`,
evidence for downstream product surfaces, not a Metrics field, gate, score, or
authority expansion.

The next slices are Platform awareness and a `local-subscription-control` demo
pass. Platform may use the report as an explanatory preflight signal before
promotion, but not as promotion authority. Concrete handoff artifacts and
The next producer-side slices should keep using Idea Maturity and repair
contracts instead of creating a second depth metric:

1. real intake should emit browser-answerable clarification templates, or an
explicit `clarification_not_required` state, so SpecSpace product demos do
not need deterministic answer fallback fixtures;
2. candidate graphs should keep stable machine ids while publishing
human-friendly display aliases for generated nodes, candidate overview, PR
artifacts, and topology/readiness panels;
3. the older custom-run approval/promotion follow-up should be reconciled with
the managed-operation path: either document the existing arbitrary-route
Platform dry-run capability as sufficient, or add a small producer handoff so
repaired custom-run artifacts do not need to be copied into canonical
`runs/*.json`.

Platform may use depth reports and deltas as explanatory preflight signals
before promotion, but not as promotion authority. Concrete handoff artifacts and
existing gates remain the source of branch/commit/PR readiness.

Proposal `0181` adds explicit Metrics contract metadata to the maturity report:
Expand Down
44 changes: 37 additions & 7 deletions docs/product_workspace_graph_versioning_roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -1631,6 +1631,35 @@ The delta is not a Metrics schema extension, score, gate, approval signal, or
promotion condition. It is review-only evidence that helps product surfaces
explain what depth repair changed and what still needs clarification.

## Near-Term Producer Backlog After Structural Depth

Status: planned.

The structural-depth line is now part of the existing Idea Maturity and repair
contracts. Do not add another competing "depth score" or product-quality metric.
The next producer-side work should instead make the existing idea-to-spec flow
more reliable and easier for SpecSpace to present:

1. **Fallback-free real-intake clarification templates.** Real intake should
emit either a browser-answerable `real_idea_answer_template` or an explicit
`clarification_not_required` state. The current SpecSpace product-demo
fallback remains a temporary local harness policy, not a producer contract.
A strict UI-started demo should be able to pass without deterministic answer
fixtures while still proving that the candidate came from the new workspace
rather than the Team Decision Log pilot.
2. **Human-friendly candidate display aliases.** Keep stable machine ids for
refs, materialization, and promotion paths, but add deterministic display
aliases or readable labels for long generated candidate node ids. Candidate
overview, PR artifacts, and SpecSpace topology/readiness panels should show
the alias while preserving the canonical id in evidence refs.
3. **Custom-run approval/promotion handoff reconciliation.** The local
managed-operation chain can already drive arbitrary workspace routes through
approval and promotion dry-run paths. Reconcile that with the older
cash-flow smoke follow-up: if the existing Platform wrappers cover custom
run directories, replace the follow-up with a documented verification target;
otherwise add a small producer-side handoff artifact that prevents operators
from copying repaired custom-run artifacts into canonical `runs/*.json`.

## Real Idea Entry Request Import

Status: implemented producer-side in proposal `0202`; downstream UI/Platform
Expand Down Expand Up @@ -1781,16 +1810,17 @@ The same run exposed the next product-flow friction points:
runs can now call `make real-idea-smoke-depth-baseline` to fail shallow demos
that lack event-storming depth, workflow topology, candidate overview, or
Idea Maturity before SpecSpace presents them as a product story.
11. **Human-friendly candidate ids.** Long constraint statements currently
11. **Human-friendly candidate ids.** Planned. Long constraint statements currently
produce truncated node ids. Keep stable machine ids, but add shorter
readable slugs or display aliases for UI, PR artifacts, and candidate
overview documents.
12. **Custom-run Platform promotion dry-run.** The cash-flow smoke reached
`ready_for_platform_promotion_request`, but did not yet materialize an
approval decision, promotion request, or Git Service dry-run. Add a reusable
custom run-dir handoff so any repaired real-idea smoke can continue into the
existing Platform approval/promotion dry-run boundary without copying
artifacts into canonical `runs/*.json`.
12. **Custom-run Platform promotion dry-run.** Needs reconciliation. Later
SpecSpace/Platform managed-operation smokes proved arbitrary-route
approval/promotion dry-runs, but this cash-flow-specific follow-up should be
closed only after the run-dir binding is verified against a repaired
real-idea smoke and documented as either an existing Platform capability or a
small new producer handoff. Avoid copying custom-run artifacts into canonical
`runs/*.json`.

## Team Decision Log Happy-Path Repair Pack

Expand Down