git:20250801.86af7ed to git:20260330.8094d37

# AI Agent Guidelines - guidance

> **Generated by**: [golden-agents](https://github.com/bordenet/golden-agents) v1.4.0 (progressive)

> **Last Updated**: 2026-02-05

> **Languages**: javascript

> **Type**: general

Minimal core with on-demand module loading. Templates at: `$HOME/.golden-agents/templates/`

<!-- GOLDEN:self-manage:start -->

## ⚠️ Before ANY Task

1. Load `.ai-guidance/invariants.md` — contains critical rules

2. After editing ANY guidance file, check: `wc -l AGENTS.md .ai-guidance/*.md 2>/dev/null`

- `AGENTS.md` >150 lines → refactor into `.ai-guidance/`

- Any `.ai-guidance/*.md` >50 lines → split into sub-directory

<!-- GOLDEN:self-manage:end -->

<!-- GOLDEN:framework:start -->

---

## Quality Gates (MANDATORY)

Before ANY commit:

1. **Lint**: `npm run lint`

2. **Build**: `npm run build`

3. **Test**: `npm test`

4. **Coverage**: Minimum 70%

**Order matters.** Lint → Build → Test. Never skip steps.

---

## Communication Rules

- **No flattery** - Skip "Great question!" or "Excellent point!"

- **No hype** - Avoid "revolutionary", "game-changing", "seamless"

- **Evidence-based** - Cite sources or qualify as opinion

- **Direct** - State facts without embellishment

**Banned phrases**: production-grade, world-class, leverage, utilize, incredibly, extremely, Happy to help!

---

## 🚨 Progressive Module Loading

**STOP and load the relevant module BEFORE these actions:**

### Language Modules (🔴 Required)

- 🔴 **BEFORE writing ANY `.js`, `.ts`, `.jsx`, `.tsx` file**: Read `$HOME/.golden-agents/templates/languages/javascript.md`

### Workflow Modules (🔴 Required)

- 🔴 **BEFORE any commit, PR, push, or merge**: Read `$HOME/.golden-agents/templates/workflows/security.md`

- 🔴 **WHEN tests fail OR after 2+ failed fix attempts**: Read `$HOME/.golden-agents/templates/workflows/testing.md`

- 🔴 **WHEN build fails OR lint errors appear**: Read `$HOME/.golden-agents/templates/workflows/build-hygiene.md`

- 🟡 **BEFORE deploying to any environment**: Read `$HOME/.golden-agents/templates/workflows/deployment.md`

- 🟡 **WHEN conversation exceeds 50 exchanges**: Read `$HOME/.golden-agents/templates/workflows/context-management.md`

### Optional: Superpowers integration

If [superpowers](https://github.com/obra/superpowers) is installed, run at session start:

```bash

node ~/.codex/superpowers-augment/superpowers-augment.js bootstrap

```

<!-- GOLDEN:framework:end -->

---

## Project-Specific Rules

This is the `guidance` folder for golden-agents templates.

- **Purpose**: Source for progressive module loading templates

- **Templates**: Located at `$HOME/.golden-agents/templates/`

- **Usage**: These templates are loaded on-demand by other projects

No additional project-specific rules required.