Skip to content

dogfood gap: charter repo fails its own audit (0/100), no patterns or policy docs #159

@stackbilt-admin

Description

@stackbilt-admin

Problem

Running charter audit on the charter repo itself returns 0/100 FAIL:

Score: [fail] 0/100

Git Governance Coverage
  Commits analyzed:   5
  With trailers:      0 (0%)

Blessed Stack Patterns
  Total defined:      0

Policy Documentation
  Policy files:       0
  Missing sections:   4

Similarly, charter doctor warns on the repo's own setup:

  • No patterns found in .charter/patterns/*.json
  • No policy markdown files

charter drift also reports nothing to scan because no patterns are defined.

Impact

Charter is the governance CLI. If it doesn't govern itself, it undermines the entire pitch. A potential adopter running charter audit during evaluation would see this as a red flag.

Fix

  1. Add at minimum 2-3 .charter/patterns/*.json examples to the repo (can be governance-specific: ADF mutation patterns, release trailer patterns)
  2. Add a docs/governance-policy.md covering the 4 required sections: Commit Trailers, Change Classification, Exception Path, Escalation & Approval
  3. Start adding Governed-By: trailers to release commits and breaking changes
  4. Bootstrap .charter/ as a reference implementation that scores ≥80 on its own audit

This also serves as living documentation for adopters — "here's exactly what a well-configured charter repo looks like."

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions