cpp-standards-guideline-system

name	cpp-standards-guideline-system
description	Parse AUTOSAR, MISRA, and similar C++ standards documents, extract rule records, map rule interactions, and synthesize a core guideline with canonical coding patterns and fix-order guidance.
argument-hint	Describe the standard, source PDF path, output filename, artifact root, and any project-specific coding preferences
user-invocable	true

C++ Standards Guideline System

Use this skill to turn a rule-heavy C++ standards document into a practical core guideline that engineers can follow consistently.

What This Skill Produces

• a manifest and runbook
• a parsed source artifact
• normalized rule records
• a rule relationship artifact
• a Mermaid rule graph
• a final core guideline markdown file
• a verification report

When To Use

• building a core coding guideline from AUTOSAR or MISRA C++ source material
• analyzing a standards PDF to derive preferred canonical coding forms
• mapping where coding rules reinforce or interfere with each other
• generating a practical coding guide that reduces multi-rule violations

Procedure

1. Use the requirements template to normalize the job.
2. Create the initial manifest using manifest-template.json.
3. Install parser dependencies from ./scripts/requirements.txt if needed.
4. Parse the PDF using parse_guideline_pdf.py.
5. Extract normalized rule records using the rule normalization method.
6. Map rule interactions using the dependency graph method.
7. Generate the rule graph with build_rule_graph.py.
8. Synthesize the final guide using the final guideline template.
9. Validate the result against the output contract.

Required Runtime Artifacts

• artifacts/cpp-standards-guideline/manifest.json
• artifacts/cpp-standards-guideline/runbook.md
• artifacts/cpp-standards-guideline/source-markdown.md or source-text.txt
• artifacts/cpp-standards-guideline/rules-normalized.json
• artifacts/cpp-standards-guideline/rule-relationships.json
• artifacts/cpp-standards-guideline/rule-graph.mmd
• artifacts/cpp-standards-guideline/verification-report.md

References

• Workflow
• Rule normalization method
• Dependency graph method
• Canonical pattern synthesis
• Output contract
• Copyright-safe synthesis

Templates and Schemas

• Requirements template
• Manifest template
• Runbook template
• Rule record schema
• Relationship schema
• Final guideline template