QA Test Doc Compiler
Purpose
Compile formal test documentation per ISO/IEC/IEEE 29119-3. Collect inputs from other QA skills, organize content per ISO structure, format documents, and validate completeness. Supports tailoring for Agile, Scrum, and DevOps contexts.
Document Types
| Category |
Document Types |
| Governance |
Test Policy, Organizational Test Practices |
| Planning |
Project Test Plan, Level Test Plans (unit/integration/system/acceptance), Type Test Plans (functional/performance/security) |
| Specification |
Test Model Specification, Test Case Specification, Test Procedure Specification |
| Execution |
Test Execution Log, Test Incident Report |
| Reporting |
Test Status Report, Test Completion Report |
| Readiness |
Test Data Requirements, Test Environment Requirements, Test Data Readiness Report, Test Environment Readiness Report |
See references/iso-29119-3-documents.md for required sections per document type.
Document Compilation Workflow
Collect inputs — Gather content from other skills:
qa-requirements-generator → requirements, acceptance criteria
qa-plan-creator → test plans, sprint plans, release plans
qa-spec-writer → specifications, acceptance criteria
qa-testcase-from-docs → test cases, RTM
qa-nfr-analyst → NFR criteria for performance/security plans
- Manual inputs: execution logs, incident reports, status updates
Organize per ISO structure — Map content to ISO 29119-3 document templates. Use references/iso-29119-3-documents.md for mandatory/recommended sections.
Format — Apply consistent formatting (Markdown, tables, traceability IDs). Call qa-diagram-generator for Gantt charts, flowcharts, or RTM visualizations when needed.
Validate completeness — Check:
- All mandatory sections present
- Traceability links preserved (requirement → test model → test case → procedure)
- IDs follow project conventions
- No orphaned references
Tailor for context — If Agile/DevOps, apply references/agile-tailoring.md to reduce ceremony and merge documents where appropriate.
Trigger Phrases
- "Compile test documentation per ISO 29119-3"
- "Create test policy / organizational test practices"
- "Assemble test plan from [sources]"
- "Format test execution log / incident report"
- "Generate test completion report"
- "Tailor ISO 29119-3 for Agile/DevOps"
Scope
Can do (autonomous):
- Compile any ISO 29119-3 document type from provided inputs
- Organize content into ISO structure
- Merge outputs from multiple QA skills into coherent documents
- Apply Agile/DevOps tailoring per reference guide
- Call qa-diagram-generator for timelines, RTM, flowcharts
- Validate mandatory sections and traceability
Cannot do (requires confirmation):
- Create content from scratch without inputs (policy, practices, plans need stakeholder input)
- Override organizational test policy or practices
- Change scope or priorities set by stakeholders
Will not do (out of scope):
- Execute tests or automation
- Modify production code or environments
- Approve documents (approval is stakeholder responsibility)
- Generate test code
Embedding: Diagram Generator
When visualization is needed, reference qa-diagram-generator:
- Timelines →
references/gantt.md
- Traceability →
references/flowchart.md or mindmap
- Test flow →
references/sequence.md
Quality Checklist
Troubleshooting
| Symptom |
Likely Cause |
Fix |
| Missing mandatory sections |
Inputs incomplete or wrong document type |
Check references/iso-29119-3-documents.md; request missing inputs |
| Broken traceability links |
IDs changed or content merged incorrectly |
Re-map requirement → test case links; validate RTM |
| Document too heavy for Agile |
Full ISO structure applied |
Apply references/agile-tailoring.md; merge/omit non-essential sections |
| Inconsistent formatting |
Multiple sources with different styles |
Normalize to single template; use consistent ID prefixes |
| Orphaned references |
Deleted or renamed items |
Audit references; update or remove broken links |
| Policy conflicts with plan |
Stakeholder input contradicts |
Flag for resolution; do not override policy |
Reference Files
| Topic |
File |
| ISO 29119-3 document types & sections |
references/iso-29119-3-documents.md |
| Agile/Scrum/DevOps tailoring |
references/agile-tailoring.md |
1---2name: qa-test-doc-compiler3description: Compile formal test documentation per ISO/IEC/IEEE 29119-3 including test policies, plans, specifications, execution logs, incident reports, and completion reports.4---56# QA Test Doc Compiler78## Purpose910Compile formal test documentation per ISO/IEC/IEEE 29119-3. Collect inputs from other QA skills, organize content per ISO structure, format documents, and validate completeness. Supports tailoring for Agile, Scrum, and DevOps contexts.1112## Document Types1314| Category | Document Types |15| -------- | -------------- |16| **Governance** | Test Policy, Organizational Test Practices |17| **Planning** | Project Test Plan, Level Test Plans (unit/integration/system/acceptance), Type Test Plans (functional/performance/security) |18| **Specification** | Test Model Specification, Test Case Specification, Test Procedure Specification |19| **Execution** | Test Execution Log, Test Incident Report |20| **Reporting** | Test Status Report, Test Completion Report |21| **Readiness** | Test Data Requirements, Test Environment Requirements, Test Data Readiness Report, Test Environment Readiness Report |2223See `references/iso-29119-3-documents.md` for required sections per document type.2425## Document Compilation Workflow26271. **Collect inputs** — Gather content from other skills:28 - `qa-requirements-generator` → requirements, acceptance criteria29 - `qa-plan-creator` → test plans, sprint plans, release plans30 - `qa-spec-writer` → specifications, acceptance criteria31 - `qa-testcase-from-docs` → test cases, RTM32 - `qa-nfr-analyst` → NFR criteria for performance/security plans33 - Manual inputs: execution logs, incident reports, status updates34352. **Organize per ISO structure** — Map content to ISO 29119-3 document templates. Use `references/iso-29119-3-documents.md` for mandatory/recommended sections.36373. **Format** — Apply consistent formatting (Markdown, tables, traceability IDs). Call `qa-diagram-generator` for Gantt charts, flowcharts, or RTM visualizations when needed.38394. **Validate completeness** — Check:40 - All mandatory sections present41 - Traceability links preserved (requirement → test model → test case → procedure)42 - IDs follow project conventions43 - No orphaned references44455. **Tailor for context** — If Agile/DevOps, apply `references/agile-tailoring.md` to reduce ceremony and merge documents where appropriate.4647## Trigger Phrases4849- "Compile test documentation per ISO 29119-3"50- "Create test policy / organizational test practices"51- "Assemble test plan from [sources]"52- "Format test execution log / incident report"53- "Generate test completion report"54- "Tailor ISO 29119-3 for Agile/DevOps"5556## Scope5758**Can do (autonomous):**59- Compile any ISO 29119-3 document type from provided inputs60- Organize content into ISO structure61- Merge outputs from multiple QA skills into coherent documents62- Apply Agile/DevOps tailoring per reference guide63- Call qa-diagram-generator for timelines, RTM, flowcharts64- Validate mandatory sections and traceability6566**Cannot do (requires confirmation):**67- Create content from scratch without inputs (policy, practices, plans need stakeholder input)68- Override organizational test policy or practices69- Change scope or priorities set by stakeholders7071**Will not do (out of scope):**72- Execute tests or automation73- Modify production code or environments74- Approve documents (approval is stakeholder responsibility)75- Generate test code7677## Embedding: Diagram Generator7879When visualization is needed, reference qa-diagram-generator:80- **Timelines** → `references/gantt.md`81- **Traceability** → `references/flowchart.md` or mindmap82- **Test flow** → `references/sequence.md`8384## Quality Checklist8586- [ ] Document type matches ISO 29119-3 definition87- [ ] All mandatory sections present per `references/iso-29119-3-documents.md`88- [ ] Traceability links preserved (REQ → model → case → procedure)89- [ ] IDs follow project conventions (e.g., TC-001, TIR-001)90- [ ] Agile tailoring applied when context is Agile/DevOps91- [ ] No hardcoded secrets or sensitive data92- [ ] Format consistent (Markdown, tables, headings)9394## Troubleshooting9596| Symptom | Likely Cause | Fix |97| ------- | ------------ | --- |98| Missing mandatory sections | Inputs incomplete or wrong document type | Check `references/iso-29119-3-documents.md`; request missing inputs |99| Broken traceability links | IDs changed or content merged incorrectly | Re-map requirement → test case links; validate RTM |100| Document too heavy for Agile | Full ISO structure applied | Apply `references/agile-tailoring.md`; merge/omit non-essential sections |101| Inconsistent formatting | Multiple sources with different styles | Normalize to single template; use consistent ID prefixes |102| Orphaned references | Deleted or renamed items | Audit references; update or remove broken links |103| Policy conflicts with plan | Stakeholder input contradicts | Flag for resolution; do not override policy |104105## Reference Files106107| Topic | File |108| ----- | ---- |109| ISO 29119-3 document types & sections | `references/iso-29119-3-documents.md` |110| Agile/Scrum/DevOps tailoring | `references/agile-tailoring.md` |