Task Contracts Catalog
DOCCAD provides a catalog of pre-configured task contracts governing distinct documentation transformations:
| Contract Name | Target Purpose | Primary Inputs | Output Artifact | Persistence |
|---|---|---|---|---|
GenerateRecruiterPage | Produce recruiter-focused profiles | Audience depth (30s, 2min, deep) | docs/generated/recruiter/*.mdx | PR |
GenerateInterviewPrep | Generate technical interview cards | Canonical doc ID | docs/generated/interview/*.interview.json | PR |
GenerateQuestionPage | Answer user questions with citations | Question text, audience, privacy | docs/generated/questions/q-*.mdx | PR |
GenerateTroubleshootingGuide | Map error symptoms to runbook fixes | Error message / symptom scope | docs/generated/troubleshooting/*.mdx | PR |
GenerateArchitectureManual | Compile deep technical manuals | Architecture subsystem scope | docs/generated/manuals/*.mdx | PR |
UpdateMermaidDiagram | Propose architecture diagram updates | Diagram path + change intent | docs/diagrams/*.mmd | PR |
Contract Invariant Rules
- Every contract mandates a
prohibitedsection forbidding fabricated metrics or ungrounded claims. - Every contract enforces
allowed_evidencerestrictions. - All persistent outputs require a reviewed PR before inclusion in canonical release builds.