CRASH Reference: Rules¶
GENERATED FILE -- do not hand-edit. Produced from every item under
src/gald3r_core/platform/pipeline/neutral_source/rules/bygald3r platform crash-reference. To regenerate:uv run gald3r platform crash-reference --apply.
Rules load automatically at the start of every session (or whenever their file glob matches) -- there is no invocation, no argument list, and no -h. They encode standing constraints a project should never have to restate out loud. This page lists every rule this repo ships, grouped by the subsystem it protects.
19 rules total.
Browse by category¶
Tasks¶
Creating, updating, and tracking work in .gald3r/tasks/.
g-rl-34-todo_completion_gate-- Stub/TODO lifecycle enforcement
Bugs & Quality¶
Reporting, fixing, and archiving defects; QA workflows.
g-rl-04-code_reusability-- DRY enforcementg-rl-35-bug-discovery-gate-- Bug-discovery gateg-rl-42-meaningful-naming-- Meaningful, specific naming
Pipelines & Autopilot (the g-go family)¶
Implement/review pipelines, swarms, autopilot loops, and agent hiring.
g-rl-37-think-in-code-- Collapse 3+ sequential reads/greps/status-checks into a single script instead of many tool callsg-rl-40-foundation-truths-- Foundation truthsg-rl-43-gald3r-search-mandate-- Prefer the gald3r search CLI verb for codebase content search; mandatory whenever a search must see .gald3r/ or .gald3r_sys/g-rl-45-loop-routing-cost-ladder-- Interactive loop/autopilot requests default to /g-go* pipelines; the gald3r autopilot verb is reserved for detached useg-rl-46-chat-vs-factory-placement-- Chat-vs-factory rule placement test
Setup & Project Identity¶
First-time setup, PROJECT.md/CONSTRAINTS.md, ideas, and personality.
g-rl-01-documentation-- Documentation file placement and naming standardsg-rl-33-enforcement_catchall-- Ambient enforcement guardrailsg-rl-38-component-creation-standards-- Component creation standards
WPAC & Workspace Coordination¶
Cross-project topology, inbox triage, broadcasts, and Workspace-Control.
g-rl-36-workspace-member-gald3r-guard-- Workspace-Control member .gald3r/ marker-only guard (HARD RULE)
Release & Versioning¶
CHANGELOG promotion, release records, ROADMAP, ship/ hotfix flow.
g-rl-26-readme-changelog-- Agents must update CHANGELOG.md and README.md when completing user-facing feature tasks
Platforms & Providers¶
Cross-IDE install/parity, per-platform specs, PowerShell/CLI reference.
g-rl-08-powershell-- PowerShell-on-Windows syntax rules, curl/Invoke-WebRequest mapping, and single-line Python invocation
Security & Compliance¶
Secret scanning, license/dependency compliance, git-sanity gates.
g-rl-02-git_workflow-- Git workflow conventions
Memory & Knowledge¶
Session learning, memory recall, and knowledge-graph tooling.
g-rl-44-vault-first-research-- Query the local vault before internet research and clearly report the lookup outcome
Logging & Diagnostics¶
Activation stats, chat logs, and session diagnostics.
g-rl-00-always-- Response footer contract (timestamp, tools, measured context) and the token-count file-size split gate
Other¶
No subsystem group declared, or a declared group outside the canonical PRODUCT_SYSTEMS.md registry -- see each item's own card for which case applies.
gald3r_personality-- MANDATORY Norse Pantheon startup team personas for all responses
Full reference¶
g-rl-00-always¶
Rule ID: g-rl-00-always
Group: Logging & Diagnostics
Purpose: Response footer contract (timestamp, tools, measured context) and the token-count file-size split gate
When to use: Response footer contract (timestamp, tools, measured context) and the token-count file-size split gate. Loads automatically every session (alwaysApply: true) -- no invocation.
Arguments: none
Example invocation:
No direct invocation -- see "When to use" above.
Always apply: True
Globs: none declared
Related: none in the same group
Source: src/gald3r_core/platform/pipeline/neutral_source/rules/g-rl-00-always.md
g-rl-01-documentation¶
Rule ID: g-rl-01-documentation
Group: Setup & Project Identity
Purpose: Documentation file placement and naming standards
When to use: Documentation file placement and naming standards. Loads automatically every session (alwaysApply: true) -- no invocation.
Arguments: none
Example invocation:
No direct invocation -- see "When to use" above.
Always apply: True
Globs: none declared
Related: g-rl-33-enforcement_catchall, g-rl-38-component-creation-standards
Source: src/gald3r_core/platform/pipeline/neutral_source/rules/g-rl-01-documentation.md
g-rl-02-git_workflow¶
Rule ID: g-rl-02-git_workflow
Group: Security & Compliance
Purpose: Git workflow conventions
When to use: Git workflow conventions — commit message format and branch standards. Loads when its declared file glob matches the files in play -- no manual invocation.
Arguments: none
Example invocation:
No direct invocation -- see "When to use" above.
Always apply: False
Globs: none declared
Related: none in the same group
Source: src/gald3r_core/platform/pipeline/neutral_source/rules/g-rl-02-git_workflow.md
g-rl-04-code_reusability¶
Rule ID: g-rl-04-code_reusability
Group: Bugs & Quality
Purpose: DRY enforcement
When to use: DRY enforcement -- 3-strike rule for extracting duplicated logic into shared modules. Loads as part of the platform's rule surface -- no manual invocation.
Arguments: none
Example invocation:
No direct invocation -- see "When to use" above.
Always apply: unspecified
Globs: none declared
Related: g-rl-35-bug-discovery-gate, g-rl-42-meaningful-naming
Source: src/gald3r_core/platform/pipeline/neutral_source/rules/g-rl-04-code_reusability.md
g-rl-08-powershell¶
Rule ID: g-rl-08-powershell
Group: Platforms & Providers
Purpose: PowerShell-on-Windows syntax rules, curl/Invoke-WebRequest mapping, and single-line Python invocation
When to use: PowerShell-on-Windows syntax rules, curl/Invoke-WebRequest mapping, and single-line Python invocation. Loads as part of the platform's rule surface -- no manual invocation.
Arguments: none
Example invocation:
No direct invocation -- see "When to use" above.
Always apply: unspecified
Globs: none declared
Related: none in the same group
Source: src/gald3r_core/platform/pipeline/neutral_source/rules/g-rl-08-powershell.md
g-rl-26-readme-changelog¶
Rule ID: g-rl-26-readme-changelog
Group: Release & Versioning
Purpose: Agents must update CHANGELOG.md and README.md when completing user-facing feature tasks
When to use: Agents must update CHANGELOG.md and README.md when completing user-facing feature tasks. Loads automatically every session (alwaysApply: true) -- no invocation.
Arguments: none
Example invocation:
No direct invocation -- see "When to use" above.
Always apply: True
Globs: ['/*.md', '/.mdc', '/.json']
Related: none in the same group
Source: src/gald3r_core/platform/pipeline/neutral_source/rules/g-rl-26-readme-changelog.md
g-rl-33-enforcement_catchall¶
Rule ID: g-rl-33-enforcement_catchall
Group: Setup & Project Identity
Purpose: Ambient enforcement guardrails
When to use: Ambient enforcement guardrails — always active regardless of which agent is loaded. Loads automatically every session (alwaysApply: true) -- no invocation.
Arguments: none
Example invocation:
No direct invocation -- see "When to use" above.
Always apply: True
Globs: none declared
Related: g-rl-01-documentation, g-rl-38-component-creation-standards
Source: src/gald3r_core/platform/pipeline/neutral_source/rules/g-rl-33-enforcement_catchall.md
g-rl-34-todo_completion_gate¶
Rule ID: g-rl-34-todo_completion_gate
Group: Tasks
Purpose: Stub/TODO lifecycle enforcement
When to use: Stub/TODO lifecycle enforcement — fires at stub creation time AND at completion gate; stubs require forward-linking comments and follow-up tasks before moving on. Loads automatically every session (alwaysApply: true) -- no invocation.
Arguments: none
Example invocation:
No direct invocation -- see "When to use" above.
Always apply: True
Globs: none declared
Related: none in the same group
Source: src/gald3r_core/platform/pipeline/neutral_source/rules/g-rl-34-todo_completion_gate.md
g-rl-35-bug-discovery-gate¶
Rule ID: g-rl-35-bug-discovery-gate
Group: Bugs & Quality
Purpose: Bug-discovery gate
When to use: Bug-discovery gate — bugs found during implementation are never silently ignored: current-task bugs fixed inline, pre-existing bugs logged with BUG[BUG-{id}] comment. Loads automatically every session (alwaysApply: true) -- no invocation.
Arguments: none
Example invocation:
No direct invocation -- see "When to use" above.
Always apply: True
Globs: none declared
Related: g-rl-04-code_reusability, g-rl-42-meaningful-naming
Source: src/gald3r_core/platform/pipeline/neutral_source/rules/g-rl-35-bug-discovery-gate.md
g-rl-36-workspace-member-gald3r-guard¶
Rule ID: g-rl-36-workspace-member-gald3r-guard
Group: WPAC & Workspace Coordination
Purpose: Workspace-Control member .gald3r/ marker-only guard (HARD RULE)
When to use: Workspace-Control member .gald3r/ marker-only guard (HARD RULE) — a controlled_member or migration_source repository may carry ONLY .identity + PROJECT.md; live control-plane state (TASKS.md, BUGS.md, tasks/, bugs/, PLAN.md, FEATURES.md, SUBSYSTEMS.md, ...) is forbidden and must be blocked, not merely discouraged. Loads automatically every session (alwaysApply: true) -- no invocation.
Arguments: none
Example invocation:
No direct invocation -- see "When to use" above.
Always apply: True
Globs: none declared
Related: none in the same group
Source: src/gald3r_core/platform/pipeline/neutral_source/rules/g-rl-36-workspace-member-gald3r-guard.md
g-rl-37-think-in-code¶
Rule ID: g-rl-37-think-in-code
Group: Pipelines & Autopilot (the g-go family)
Purpose: Collapse 3+ sequential reads/greps/status-checks into a single script instead of many tool calls
When to use: Collapse 3+ sequential reads/greps/status-checks into a single script instead of many tool calls. Loads as part of the platform's rule surface -- no manual invocation.
Arguments: none
Example invocation:
No direct invocation -- see "When to use" above.
Always apply: unspecified
Globs: none declared
Related: g-rl-40-foundation-truths, g-rl-43-gald3r-search-mandate, g-rl-45-loop-routing-cost-ladder, g-rl-46-chat-vs-factory-placement
Source: src/gald3r_core/platform/pipeline/neutral_source/rules/g-rl-37-think-in-code.md
g-rl-38-component-creation-standards¶
Rule ID: g-rl-38-component-creation-standards
Group: Setup & Project Identity
Purpose: Component creation standards
When to use: Component creation standards — subsystem tagging required on all .gald3r_sys components. Loads automatically every session (alwaysApply: true) -- no invocation.
Arguments: none
Example invocation:
No direct invocation -- see "When to use" above.
Always apply: True
Globs: none declared
Related: g-rl-01-documentation, g-rl-33-enforcement_catchall
Source: src/gald3r_core/platform/pipeline/neutral_source/rules/g-rl-38-component-creation-standards.md
g-rl-40-foundation-truths¶
Rule ID: g-rl-40-foundation-truths
Group: Pipelines & Autopilot (the g-go family)
Purpose: Foundation truths
When to use: Foundation truths — durable corrections for failures that recurred across sessions for 6 months. Read before acting; these override convenience. Loads automatically every session (alwaysApply: true) -- no invocation.
Arguments: none
Example invocation:
No direct invocation -- see "When to use" above.
Always apply: True
Globs: none declared
Related: g-rl-37-think-in-code, g-rl-43-gald3r-search-mandate, g-rl-45-loop-routing-cost-ladder, g-rl-46-chat-vs-factory-placement
Source: src/gald3r_core/platform/pipeline/neutral_source/rules/g-rl-40-foundation-truths.md
g-rl-42-meaningful-naming¶
Rule ID: g-rl-42-meaningful-naming
Group: Bugs & Quality
Purpose: Meaningful, specific naming
When to use: Meaningful, specific naming — no generic single-word collisions (daemon/manager/handler/service/client). Fires whenever naming code symbols, files, folders, subsystems, or task/bug titles. Loads automatically every session (alwaysApply: true) -- no invocation.
Arguments: none
Example invocation:
No direct invocation -- see "When to use" above.
Always apply: True
Globs: none declared
Related: g-rl-04-code_reusability, g-rl-35-bug-discovery-gate
Source: src/gald3r_core/platform/pipeline/neutral_source/rules/g-rl-42-meaningful-naming.md
g-rl-43-gald3r-search-mandate¶
Rule ID: g-rl-43-gald3r-search-mandate
Group: Pipelines & Autopilot (the g-go family)
Purpose: Prefer the gald3r search CLI verb for codebase content search; mandatory whenever a search must see .gald3r/ or .gald3r_sys/
When to use: Prefer the gald3r search CLI verb for codebase content search; mandatory whenever a search must see .gald3r/ or .gald3r_sys/. Loads automatically every session (alwaysApply: true) -- no invocation.
Arguments: none
Example invocation:
No direct invocation -- see "When to use" above.
Always apply: True
Globs: none declared
Related: g-rl-37-think-in-code, g-rl-40-foundation-truths, g-rl-45-loop-routing-cost-ladder, g-rl-46-chat-vs-factory-placement
Source: src/gald3r_core/platform/pipeline/neutral_source/rules/g-rl-43-gald3r-search-mandate.md
g-rl-44-vault-first-research¶
Rule ID: g-rl-44-vault-first-research
Group: Memory & Knowledge
Purpose: Query the local vault before internet research and clearly report the lookup outcome
When to use: Query the local vault before internet research and clearly report the lookup outcome. Loads automatically every session (alwaysApply: true) -- no invocation.
Arguments: none
Example invocation:
No direct invocation -- see "When to use" above.
Always apply: True
Globs: none declared
Related: none in the same group
Source: src/gald3r_core/platform/pipeline/neutral_source/rules/g-rl-44-vault-first-research.md
g-rl-45-loop-routing-cost-ladder¶
Rule ID: g-rl-45-loop-routing-cost-ladder
Group: Pipelines & Autopilot (the g-go family)
Purpose: Interactive loop/autopilot requests default to /g-go* pipelines; the gald3r autopilot verb is reserved for detached use
When to use: Interactive loop/autopilot requests default to /g-go* pipelines; the gald3r autopilot verb is reserved for detached use. Loads automatically every session (alwaysApply: true) -- no invocation.
Arguments: none
Example invocation:
No direct invocation -- see "When to use" above.
Always apply: True
Globs: none declared
Related: g-rl-37-think-in-code, g-rl-40-foundation-truths, g-rl-43-gald3r-search-mandate, g-rl-46-chat-vs-factory-placement
Source: src/gald3r_core/platform/pipeline/neutral_source/rules/g-rl-45-loop-routing-cost-ladder.md
g-rl-46-chat-vs-factory-placement¶
Rule ID: g-rl-46-chat-vs-factory-placement
Group: Pipelines & Autopilot (the g-go family)
Purpose: Chat-vs-factory rule placement test
When to use: Chat-vs-factory rule placement test — decides what stays always-apply vs g-go*-only. Loads automatically every session (alwaysApply: true) -- no invocation.
Arguments: none
Example invocation:
No direct invocation -- see "When to use" above.
Always apply: True
Globs: none declared
Related: g-rl-37-think-in-code, g-rl-40-foundation-truths, g-rl-43-gald3r-search-mandate, g-rl-45-loop-routing-cost-ladder
Source: src/gald3r_core/platform/pipeline/neutral_source/rules/g-rl-46-chat-vs-factory-placement.md
gald3r_personality¶
Rule ID: gald3r_personality
Group: Other (no subsystem group declared)
Purpose: MANDATORY Norse Pantheon startup team personas for all responses
When to use: MANDATORY Norse Pantheon startup team personas for all responses. Loads automatically every session (alwaysApply: true) -- no invocation.
Arguments: none
Example invocation:
No direct invocation -- see "When to use" above.
Always apply: True
Globs: none declared
Related: none in the same group
Source: src/gald3r_core/platform/pipeline/neutral_source/rules/gald3r_personality.md
Metadata note: rules/gald3r_personality.md: missing subsystem_memberships: frontmatter