git:20260225.a190152 to git:20260401.cf879a7

<!-- FOR AI AGENTS - Human readability is a side effect, not a goal -->

<!-- Managed by agent: keep sections and order; edit content, not structure -->

<!-- Last updated: 2026-02-05 | Last verified: never -->

# AGENTS.md

**Precedence:** the **closest `AGENTS.md`** to the files you're changing wins. Root holds global defaults only.

## Commands (unverified)

> Source: CI (github-actions) — CI-sourced commands are most reliable

<!-- AGENTS-GENERATED:START commands -->

| Task | Command | ~Time |

|------|---------|-------|

<!-- AGENTS-GENERATED:END commands -->

> If commands fail, verify against Makefile/package.json/composer.json or ask user to update.

## Workflow

1. **Before coding**: Read nearest `AGENTS.md` + check Golden Samples for the area you're touching

2. **After each change**: Run the smallest relevant check (lint → typecheck → single test)

3. **Before committing**: Run full test suite if changes affect >2 files or touch shared code

## File Map

<!-- AGENTS-GENERATED:START filemap -->

```

skills/ → project files

assets/ → static assets (images, fonts)

LICENSE/ → project files

```

<!-- AGENTS-GENERATED:END filemap -->

## Heuristics (quick decisions)

<!-- AGENTS-GENERATED:START heuristics -->

| When | Do |

|------|-----|

| Committing | Use Conventional Commits (feat:, fix:, docs:, etc.) |

| Merging PRs | Squash and merge |

| Adding dependency | Ask first - we minimize deps |

| Unsure about pattern | Check Golden Samples above |

<!-- AGENTS-GENERATED:END heuristics -->

## Repository Settings

<!-- AGENTS-GENERATED:START repo-settings -->

- **Default branch:** `main`

- **Merge strategy:** squash, merge, rebase

<!-- AGENTS-GENERATED:END repo-settings -->

## Boundaries

### Always Do

- Run pre-commit checks before committing

- Add tests for new code paths

- Use conventional commit format: `type(scope): subject`

### Ask First

- Adding new dependencies

- Modifying CI/CD configuration

- Changing public API signatures

- Running full e2e test suites

- Repo-wide refactoring or rewrites

### Never Do

- Commit secrets, credentials, or sensitive data

- Modify vendor/, node_modules/, or generated files

- Push directly to main/master branch

- Delete migration files or schema changes

## Index of scoped AGENTS.md

<!-- AGENTS-GENERATED:START scope-index -->

- `./skills/agent-rules/AGENTS.md` — Claude Code skill/plugin providing AI agent capabilities

- `./.github/workflows/AGENTS.md` — GitHub Actions workflows and CI/CD automation

<!-- AGENTS-GENERATED:END scope-index -->

## When instructions conflict

The nearest `AGENTS.md` wins. Explicit user prompts override files.