coding

Files (1)

• SKILL.md

SKILL.md (first lines)

# Coding

Implement, refactor, and fix code with minimal testable changes and deterministic verification.

Use this skill when:
- A new feature, route, or component needs implementation
- A bug needs diagnosis and a targeted fix
- Existing code needs refactoring for clarity, performance, or maintainability
- A patch or migration needs to be applied and verified

Do not use this skill when:
- The task is purely operational (use `operations` instead)
- The task is test strategy without code changes (use `qa` instead)
- The task is documentation-only (use `documentation` instead)

## Workflow

### Inspect

1. Read the relevant contracts, route files, and service files before editing
2. Understand the current behavior and its dependencies
3. Identify the objective, success criteria, non-goals, and constraints

### Implement

1. Make minimal, focused changes - one concern per diff
2. Prefer additive, backward-compatible changes
3. Use shared contract types from `packages/contracts` where applicable
4. Keep control flow deterministic and names clear

### Verify

1. Choose validation proportional to the risk and surface area of the change
2. For TypeScript/runtime changes, prefer targeted tests first, then broaden to `pnpm -r typecheck` or `pnpm -r test` when shared contracts or cross-package behavior changed
3. Add or update tests for bug fixes and behavior changes
4. Use smoke or verification lanes when the change touches shipped workflows, routing, or release gates
5. Summarize what changed, what was validated, and what still needs attention

## Safety Rules

- Keep policy precedence and safety boundaries intact
- Do not mix unrelated cleanup into behavior changes
- Do not silently change behavior - document material impacts
- Preserve deny-wins, approvals, and grants precedence

## Tools You May Use

- `fs.read` - inspect source files and contracts
- `fs.write` - apply code changes
- `shell.exec` - run builds, tests, and validation commands
- `git.exec` - manage commits and diffs

From goatcitadel/GoatCitadel, Apache-2.0.

More from goatcitadel/GoatCitadel