fast-dev — lightweight flow for narrow, low-risk changes
This is the lightweight tier of AGENTS.md → "Change Workflow". It exists so a
small change does not pay the full self-dev ceremony. The tier table in AGENTS.md
is the authoritative routing rule; this skill defers to it.
fast-dev requires an explicit user opt-in. If the user did not opt into
fast-dev, default to self-dev.
In scope (only these)
- Documentation / copy edits.
- Static assets.
- A localized console UI tweak with a contained blast radius.
- A clearly isolated helper or utility.
- A localized test adjustment.
Out of scope — escalate to self-dev
If the change touches DB schema, migrations, storage/seed, auth / permissions /
ownership, secrets, deployment / release, queue / worker / runtime adapters, Feishu
event handling, the daemon gateway, or is a broad / architectural refactor — stop
and switch to self-dev, stating why. This applies even if you only discover the
tier-2 surface mid-flight.
Flow
- Confirm a one-line intent and the few files in scope. Keep the change focused —
no unrequested "opportunistic" edits.
- Make the change. Prefer test-first when a behavior is involved; for pure
docs/copy/assets, a test may not apply.
- Focused verification — run the checks relevant to what you touched, e.g.:
- touched
.ts: pnpm lint, pnpm typecheck, pnpm build, and the affected
package's pnpm --filter @open-tag/<pkg> test;
- touched a workspace
package.json / docs that a test pins: the test guarding it;
- console UI / web change: validate the rendered behavior in a browser, check
the browser console for errors, and capture a screenshot as acceptance evidence.
- Explicitly report the gates you skipped and why (e.g. "skipped Postgres
integration + API E2E: docs-only change, no runtime path touched"). Never imply
the full suite ran when it did not.
- Commit with a clear message:
git commit -m "<type>(<scope>): <summary>".
- Open a PR per
AGENTS.md ("Commit and PR") when the change warrants one. Outward
actions (push, PR, merge) are confirmed with the user.
Rules
- All code, comments, docs, and PR text are in English.
- Never modify
.env, infra/, .git/, pnpm-lock.yaml, *.key, *.pem.
- Run every git command from the current worktree.
- Never commit credentials, real tenant identifiers, or internal-only references.
1---2name: fast-dev3description: Use ONLY with explicit user opt-in for a narrow, low-risk OpenClaudeTag repo change — docs/copy, static assets, a localized console UI tweak, a clearly isolated helper, or a localized test adjustment. Do focused verification and explicitly report which full gates you skipped. If the change turns out to touch any tier-2 area (schema, auth, queue/worker/runtime, Feishu events, daemon, secrets, deployment, or a broad refactor), stop and switch to self-dev.4---56# fast-dev — lightweight flow for narrow, low-risk changes78This is the lightweight tier of `AGENTS.md` → "Change Workflow". It exists so a9small change does not pay the full self-dev ceremony. The tier table in `AGENTS.md`10is the authoritative routing rule; this skill defers to it.1112**fast-dev requires an explicit user opt-in.** If the user did not opt into13fast-dev, default to `self-dev`.1415## In scope (only these)1617- Documentation / copy edits.18- Static assets.19- A localized console UI tweak with a contained blast radius.20- A clearly isolated helper or utility.21- A localized test adjustment.2223## Out of scope — escalate to self-dev2425If the change touches DB schema, migrations, storage/seed, auth / permissions /26ownership, secrets, deployment / release, queue / worker / runtime adapters, Feishu27event handling, the daemon gateway, or is a broad / architectural refactor — **stop28and switch to self-dev**, stating why. This applies even if you only discover the29tier-2 surface mid-flight.3031## Flow32331. Confirm a one-line intent and the few files in scope. Keep the change focused —34 no unrequested "opportunistic" edits.352. Make the change. Prefer test-first when a behavior is involved; for pure36 docs/copy/assets, a test may not apply.373. **Focused verification** — run the checks relevant to what you touched, e.g.:38 - touched `.ts`: `pnpm lint`, `pnpm typecheck`, `pnpm build`, and the affected39 package's `pnpm --filter @open-tag/<pkg> test`;40 - touched a workspace `package.json` / docs that a test pins: the test guarding it;41 - **console UI / web change: validate the rendered behavior in a browser, check42 the browser console for errors, and capture a screenshot as acceptance evidence.**434. **Explicitly report the gates you skipped** and why (e.g. "skipped Postgres44 integration + API E2E: docs-only change, no runtime path touched"). Never imply45 the full suite ran when it did not.465. Commit with a clear message: `git commit -m "<type>(<scope>): <summary>"`.476. Open a PR per `AGENTS.md` ("Commit and PR") when the change warrants one. Outward48 actions (push, PR, merge) are confirmed with the user.4950## Rules5152- All code, comments, docs, and PR text are in **English**.53- Never modify `.env`, `infra/`, `.git/`, `pnpm-lock.yaml`, `*.key`, `*.pem`.54- Run every git command from the current worktree.55- Never commit credentials, real tenant identifiers, or internal-only references.
legendtkl