|
| 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