update-conventions

Solid

Use this skill when the user wants to change `docs/CONVENTIONS.md` or `docs/CHARTER.md`. Triggers on "let's change the convention for...", "update the rules", "amend the charter", "change our principles". Conventions and charter changes go through RFC review, not direct PR.

AI & Automation 14 stars 4 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 78/100

Stars 20%
39
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
54
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Skill: update-conventions Edits to `docs/CONVENTIONS.md` and `docs/CHARTER.md` are not normal PRs — they change how everyone works in the repo. They go through RFC review. ## Procedure 1. **Push back if the user starts editing directly.** Conventions changes are high-leverage; they should be deliberated. 2. Open an RFC instead. Use the `new-rfc` skill, with the RFC scoped to "change conventions section X to Y". The RFC's *Proposal* section should contain the specific edited text — the diff, essentially. 3. After the RFC is accepted, the actual edit to `CONVENTIONS.md` is a small PR that cites the RFC in the commit footer: ``` docs(conventions): adopt RFC-NNNN — <one-line summary> Implements RFC-NNNN: <link> ``` 4. Update the RFC's *Follow-on artifacts* section to point at the merged commit. ## Exception Trivial edits — typo fixes, broken-link fixes, formatting — don't need an RFC. A normal PR is fine. If you're not sure, err toward RFC: the cost of an extra RFC is small; the cost of an unannounced rule change is large.

Details

Author
eugenelim
Repository
eugenelim/agent-ready-repo
Created
2 months ago
Last Updated
today
Language
Python
License
Apache-2.0

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category