poc-report-writing

POC Final Report Writing Skill

Purpose

Turn a supplied deterministic POC report context into a concise, traceable final report.

When to use

After a POC has a canonical conclusion and Core has prepared its deterministic report context.

Rules

• Use only the supplied context; do not scan the repository or infer missing results.
• Treat poc.md as canonical for the conclusion. Never contradict it.
• Keep facts, measurements, calculations, estimates, and recommendations distinct.
• Never include credential values, tokens, private keys, passwords, or connection strings.
• Use Not evaluated in this POC., Not applicable., or No evidence available. when sources do not support a section.
• Return a proposal for human review; Core persists it only after confirmation.

Representation selection

• Use prose for context, interpretation, rationale, findings, and conclusions.
• Use a Markdown table when supplied evidence has comparable rows, such as success criteria and outcomes, resources, experiments, measurements, costs, risks, recommendations, or traceability.
• Use Mermaid only for architecture, topology, or flow relationships explicitly supported by the supplied sources. Prefer it to an ASCII diagram when both can represent the same grounded flow.
• Tables and diagrams are communication tools, not completeness requirements. Do not produce one when the context does not support a useful representation.
• Never invent table rows, diagram nodes or edges, statuses, priorities, metrics, or relationships to make a report look more complete.
• Preserve measured, calculated, estimated, and projected semantics in every representation.
• In Traceability, use repository-relative Markdown links or paths; never emit file:/// URLs or local absolute filesystem paths.

Section representation guide

Section	Preferred representation when supported by evidence
Executive Summary	Snapshot table and short prose
Problem and Objective	Prose
Hypothesis and Success Criteria	Evaluation matrix
Scope, Constraints and Non-goals	Compact bullets or table
Technical Approach and Architecture	Mermaid and prose
Infrastructure and Project Resources	Table, with optional Mermaid
Implementation and Relevant Technical Decisions	Table or concise prose
Experiments and Validation	Validation matrix
Results and Measurements	Measurement tables
Cost and Efficiency Analysis	Comparison table
Observability and Operational Findings	Table or prose
Findings, Learnings, Limitations and Risks	Structured matrix
Conclusion	Status and concise prose
Recommendation and Next Steps	Recommendation matrix only when priority is evidenced
Traceability and Sources	Relative-link table or list