dcaaeb34f3
Adds the org-wide agent process doc (QA gate, peptiderepo git identity, 300-line cap, doc-in-same-commit, branch naming, commit trailer, PR-only to main) and rewrites CLAUDE.md as a thin bootstrap pointer to it. No runtime impact. No code change. Pure process/docs ratification. Per CTO handoff in convo/prtheme/threads/2026-04-v1.5.2-release-cleanup/ 03-cto-reply.md, this is the calibration run for the rollout pattern across the four peptiderepo repos. Agent-Session: prtheme/v1.5.2-release-cleanup/claude-opus-4-6
22 lines
1.3 KiB
Markdown
22 lines
1.3 KiB
Markdown
# Agent Bootstrap — peptide-starter-theme
|
|
|
|
**Read these files in order before making any edit:**
|
|
|
|
1. `AGENT-OPERATING-STANDARD.md` — process rules, QA gate, Definition of Done. Required reading on every session.
|
|
2. `ARCHITECTURE.md` — this repo's structure, data flow, integrations, key decisions.
|
|
3. `CONVENTIONS.md` — this repo's code style and extension patterns.
|
|
|
|
## Critical rules (full detail in AGENT-OPERATING-STANDARD.md)
|
|
|
|
- **No direct pushes to `main`.** PR-only. The deploy skills will refuse to push without a signed QA verdict for the commit SHA.
|
|
- **Commits authored as `peptiderepo`** (`git config user.name "peptiderepo"` / `user.email "peptiderepo@users.noreply.github.com"`). Verify before pushing.
|
|
- **Branch naming:** `claude/<scope>-<YYYYMMDD>`.
|
|
- **Commit trailer:** `Agent-Session: <session-id-or-description>`.
|
|
- **Doc-in-same-commit:** any change to file structure or data flow must update `ARCHITECTURE.md` / `CONVENTIONS.md` in the same commit.
|
|
|
|
## QA gate
|
|
|
|
Before any deploy, the `qa-review` skill spawns a fresh subagent to review the diff against `AGENT-OPERATING-STANDARD.md`. The verdict is written to `qa-reviews/<repo>/<date>-<sha>.md` in the workspace root and must be `APPROVE` or `APPROVE-WITH-P2-NOTES` for the deploy to proceed.
|
|
|
|
The agent that wrote the code cannot self-approve. This is structural, not advisory.
|