nw-doc-as-artifact · git:20261102.c67d57b · 2026-11-02 · sha256 f4e03c20d69cc9a1
nw-doc-as-artifact git:20261102.c67d57bA
Immutable. This exact content never changes and is served at /api/v1/blob/f4e03c20d69cc9a1.
--- name: nw-doc-as-artifact description: Use briefs and HTML as shared reading surfaces for human understanding and collaborative review. user-invocable: false disable-model-invocation: true --- # Human document projection The feature's current authority is the source; Markdown briefs and HTML are generated reading surfaces. Never write a second competing narrative, edit the generated output by hand, or use an external URL as the only authority. Publication is optional and separate; never upload automatically. ## Render the current authority Render full briefs and HTML from the feature's current authority with the available renderer; use its supported options rather than reconstructing an obsolete invocation. Keep source identity and the resulting local paths with the review evidence. Inspect the rendered page and diagnostics before reporting success; an unavailable renderer is a concrete gap, not a new workflow gate. There is no wave-entry preference or density setting to read. Rendering does not establish wave completion, verification, publication or human approval. Do not invent a separate wave document, a completion event or an HTML success when rendering failed. Preserve the source and report the actual failure. ## Facilitate with the view Use the view during product refinement when it helps the conversation or the human asks. Honor an explicitly chosen alternative reading surface. Do not generate an extra view whose only consumer is software. The Product Owner's semantic values should make intent, actors, journeys, relevant states, examples, decisions and open questions understandable before formal detail. Resolve product meaning before rendering the shared view. Keep summaries brief, unresolved questions visibly open and each fact in its appropriate record. Document language follows `nw-human-collaboration`. Include stable references to prototypes and mechanically rendered scenarios and make clear which were reviewed. Explain unfamiliar terms on first use. If the human cannot explain or challenge a consequence, return the semantic correction to the PO before rendering again; styling cannot repair ambiguous requirements. Share the local HTML path and discuss one meaningful topic at a time. Regenerate the same projection after authority changes. Do not claim a view is current without rendering the current authority. No custom LLM-authored renderer, new ledger or progression gate is needed.