Skip to content

docs(repo): align documentation scopes and skill tooling - #14

Merged
specter119 merged 1 commit into
masterfrom
docs/document-scope-and-skills
Sep 19, 2026
Merged

specter119 merged 1 commit into
masterfrom
docs/document-scope-and-skills

Conversation

@specter119

Copy link
Copy Markdown
Owner

Description

  • Clarify mutually exclusive documentation ownership by fact type across AGENTS.md, README.md, product, reference, design, status, maintenance, roadmap, and milestone records.
  • Preserve M3/M4 historical evidence while removing duplicate current-contract and status definitions.
  • Add orthogonal scope boundaries and Good/Bad patterns to the six Luwu review skills.
  • Add pinned mdformat-front-matters support so YAML frontmatter in SKILL.md remains parseable while Markdown is formatted.

Related Issue

Not linked.

Potential Risk & Impact

  • Documentation and repository-hook configuration only; no runtime source code changes.
  • The formatter plugin is pinned to 2.0.0 and is used by the existing mdformat hook.
  • The main risk is documentation interpretation, mitigated by the owner map, historical links, and frontmatter validation.

How Has This Been Tested?

  • prek run --all-files
  • PYTHONDONTWRITEBYTECODE=1 PYTHONPATH=src python3 -B -m unittest discover -s tests -v (343 passed)
  • Six skill frontmatter and duplicate-name validation
  • Markdown relative-link validation and git diff --check

@specter119
specter119 merged commit 20bcae2 into master Sep 19, 2026
8 checks passed
@specter119
specter119 deleted the docs/document-scope-and-skills branch September 19, 2026 03:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant