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.md
source 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
    .rules.md
    file
  • 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)

  1. Locate all rule-like files and convention sources
  2. Classify by domain: architecture / code quality / security / testing / performance
  3. Translate each convention into standard GAAI rule format:
    • Explicit condition
    • Scope of application
    • Enforcement level
  4. Store normalized rules under
    contexts/rules/
  5. Remove ambiguity and duplication

When creating or modifying a rule file

  1. Read
    contexts/rules/README.rules.md
    — verify no existing rule already covers the intent
  2. If creating: assign the correct
    category
    and next
    id
    in sequence; add entry to index
  3. If modifying: confirm the change is a constraint refinement, not a workflow or agent behavior addition
  4. Apply the standard rule file format (YAML frontmatter + markdown body)
  5. 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.