Skip to content

Commit 611d63a

Browse files
committed
docs(agents): add build vs release mode operating policy
1 parent 9d70c55 commit 611d63a

1 file changed

Lines changed: 72 additions & 0 deletions

File tree

AGENTS.md

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
# AGENTS.md (OrgX Claude Plugin)
2+
3+
This repo uses a two-mode execution model to support long-running implementation without losing release quality.
4+
5+
## Default Mode: Build Mode
6+
Build mode is the default unless explicitly switched to release mode.
7+
8+
### Purpose
9+
- Maximize delivery speed for multi-hour implementation.
10+
- Avoid unnecessary stop-and-wait loops.
11+
- Keep work continuously shippable via checkpoints.
12+
13+
### Build-mode Rules
14+
- Confirm repo and branch once at session start.
15+
- Re-check `git status -sb` only before commits, branch switches, or destructive operations.
16+
- Batch related tasks (FE + BE + tests) when they share the same outcome.
17+
- Use requested tools when possible; if blocked, use a reliable fallback and note it briefly.
18+
- Prefer small, progressive commits for long-running work.
19+
- Run targeted verification for touched files/surfaces only.
20+
- Do not block on full-suite checks during iterative development.
21+
22+
### Build-mode Verification
23+
- Backend changes: run targeted tests for changed modules.
24+
- Frontend changes: run focused desktop/mobile smoke checks for changed flows.
25+
- Always label verification scope explicitly: `targeted`, `partial`, or `full`.
26+
27+
## Strict Mode: Release Mode
28+
Release mode is required for any PR merge, tag/release, or production-impacting action.
29+
30+
### Release-mode Triggers
31+
- User asks to merge, tag, release, or ship.
32+
- User requests final verification sign-off.
33+
34+
### Release-mode Gates
35+
- Run `typecheck`.
36+
- Run relevant unit/integration tests for all touched domains.
37+
- Verify impacted UI flows on desktop and mobile (375px for mobile surfaces).
38+
- Provide a short verification summary in PR/release notes.
39+
- Do not merge/release while unknown failing checks remain unless user explicitly approves.
40+
41+
## Decision and Approval Policy
42+
- Continue autonomously by default.
43+
- Ask user only for:
44+
- destructive git/database actions
45+
- production data changes
46+
- ambiguous product decisions with no safe default
47+
48+
## Evidence Standard
49+
- Never claim “done” or “verified” without executed commands/checks.
50+
- For workflow/timeline systems, include proof pointers when available (log path, artifact path, command result).
51+
- If proof is incomplete, state exactly what is missing.
52+
53+
## Tooling and Editing Discipline
54+
- Use `apply_patch` tool for direct file edits when appropriate.
55+
- Do not invoke `apply_patch` via shell wrappers.
56+
- Prefer MCP/system APIs for supported systems; avoid ad-hoc reimplementation unless necessary.
57+
58+
## Scope and Repo Hygiene
59+
- Operate only in the explicitly requested repo.
60+
- If multiple repos are involved, state current repo before making edits.
61+
- Never revert unrelated user changes unless explicitly requested.
62+
63+
## Safety
64+
- Never expose secrets/tokens in terminal output, code, or PR text.
65+
- Avoid irreversible operations without explicit confirmation.
66+
67+
## Reporting Format
68+
- Keep updates concise and evidence-based.
69+
- For long-running tasks, report:
70+
- `implemented`
71+
- `verified`
72+
- `remaining`

0 commit comments

Comments
 (0)