GAAI-framework rules-normalize
Convert implicit or scattered project conventions into governed GAAI rule files, and create or modify rule files with integrity. Activate during Bootstrap, when creating a new rule, or when modifying an existing rule.
install
source · Clone the upstream repo
git clone https://github.com/Fr-e-d/GAAI-framework
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/Fr-e-d/GAAI-framework "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.gaai/core/skills/cross/rules-normalize" ~/.claude/skills/fr-e-d-gaai-framework-rules-normalize && rm -rf "$T"
manifest:
.gaai/core/skills/cross/rules-normalize/SKILL.mdsource content
Rules Normalize
Purpose / When to Activate
Activate when:
- Bootstrap — project has existing conventions (linters, security policies, style guides, architecture docs, CI constraints) that need to become explicit governance
- Creating a new rule — any agent or human intends to add a new
file.rules.md - Modifying an existing rule — any agent or human intends to change the content or structure of an existing rule file
Converts all implicit conventions into explicit GAAI governance rules. Ensures rule integrity on creation and modification.
Process
When normalizing existing conventions (Bootstrap)
- Locate all rule-like files and convention sources
- Classify by domain: architecture / code quality / security / testing / performance
- Translate each convention into standard GAAI rule format:
- Explicit condition
- Scope of application
- Enforcement level
- Store normalized rules under
contexts/rules/ - Remove ambiguity and duplication
When creating or modifying a rule file
- Read
— verify no existing rule already covers the intentcontexts/rules/README.rules.md - If creating: assign the correct
and nextcategory
in sequence; add entry to indexid - If modifying: confirm the change is a constraint refinement, not a workflow or agent behavior addition
- Apply the standard rule file format (YAML frontmatter + markdown body)
- Verify no overlap or contradiction with other rule files
Quality Checks
- All critical project constraints are explicit
- Rules are machine-checkable
- No important convention remains implicit
- Governance coverage is clear
- No duplication across rule files
Non-Goals
This skill must NOT:
- Create new architectural decisions
- Modify business logic
- Enforce rules during delivery (enforcement is handled by workflows and validation stages)
No silent assumptions. Every constraint becomes explicit and governed.