v1
2 Layer 2 · Reference Approach

Integrations: GitHub-native by design.

There are no connectors to build or maintain. The whole pipeline runs on Git, GitHub Actions, and, for the advisory layer only, the Anthropic API, so there is nothing else to wire up or break.

Claude maps any source document into the standard templates, and from there it is version control the whole way down.

GitHub Actions.

Two jobs run on every pull request: audit validates each changed document, and consistency checks the whole traceability graph. Both post their results as a PR comment.

.github/workflows/audit.yml
on: [pull_request]
jobs:
  audit:        # validate each changed document
    steps:
      - { uses: actions/checkout@v4, with: { fetch-depth: 0 } }
      - uses: c4g-john/docassert-action@v1
        with: { command: validate, changed-only: 'true' }
  consistency:  # check the whole traceability graph
    steps:
      - { uses: actions/checkout@v4 }
      - uses: c4g-john/docassert-action@v1
        with: { command: consistency }

Branch protection.

Require both checks on main, and a document that fails validation or breaks a requirements trace can no longer merge.

terminal
# require both checks before a PR can merge
gh api -X PUT repos/OWNER/REPO/branches/main/protection \
  --input - <<'JSON'
{ "required_status_checks":
    { "strict": true, "contexts": ["audit", "consistency"] } }
JSON

The Anthropic API.

The one external service, used only by the advisory layer. The AI reads a document or a traceability link and scores it, and one repo secret switches it on. It fails safe: with no key, the advisory checks skip and the deterministic gate is unaffected.

terminal
# enable AI advisory scoring (optional)
gh secret set ANTHROPIC_API_KEY --repo OWNER/REPO

# without it, advisory checks report:
  ○ objective-is-specific: skipped — no ANTHROPIC_API_KEY (advisory only)

The skills & templates library.

The real “integration” is Claude itself. The doc-to-pmo skill takes a Word doc, a PDF, or pasted text and maps it into the standard Markdown templates, marking anything the source didn’t supply as a TODO.

Ships with the tool
The templates, the audit criteria, and the conversion skill all ship inside the docassert package. docassert init scaffolds them into your repo and places the skill in .claude/skills/, where Claude Code discovers it. Any source goes in, and standard, testable documents come out.

Browse the library →