docs: replace CLAUDE.md with AGENTS.md, codify agent workflow #2

Merged
vvzvlad merged 1 commits from docs/rename-claude-md-to-agents-md into develop 2026-06-20 04:19:04 +03:00

What

Renames the agent-guidance file CLAUDE.mdAGENTS.md (the opencode-standard name) and prepends a process layer on top of the existing technical/architecture content.

Changes

  • Rename CLAUDE.mdAGENTS.md (git detects 64% similarity, history preserved).
  • New top section "Жизненный цикл задачи" codifies the workflow we just went through:
    1. Sync with develop, branch off
    2. Implement (per the system-prompt workflow + subagents)
    3. Commit ONLY to Gitea and ONLY as claude_code — never as vvzvlad, never push to origin/upstream
    4. Push + PR to develop
    5. User merges; agent deletes the task's docs/backlog/<task>.md
  • New release-cycle section: before cutting a version, run the three orchestrator skills (test-orchestrator, review-orchestrator, red-team-orchestrator), fix their findings, then tag per the existing procedure.
  • Credentials cheat-sheet: agent identity, keychain service name (gitea-claude-code), Gitea PR API endpoint, base branch, and do-not-push warnings for origin/upstream.
  • Fix typo: repo slug is gitmost, not gtimost (the remote was redirecting on every push). Local gitea remote URL is updated to the canonical form.

Out of scope

No code changes — docs only.

## What Renames the agent-guidance file `CLAUDE.md` → `AGENTS.md` (the opencode-standard name) and prepends a process layer on top of the existing technical/architecture content. ## Changes - **Rename** `CLAUDE.md` → `AGENTS.md` (git detects 64% similarity, history preserved). - **New top section "Жизненный цикл задачи"** codifies the workflow we just went through: 1. Sync with `develop`, branch off 2. Implement (per the system-prompt workflow + subagents) 3. **Commit ONLY to Gitea and ONLY as `claude_code`** — never as `vvzvlad`, never push to `origin`/`upstream` 4. Push + PR to `develop` 5. User merges; agent deletes the task's `docs/backlog/<task>.md` - **New release-cycle section**: before cutting a version, run the three orchestrator skills (test-orchestrator, review-orchestrator, red-team-orchestrator), fix their findings, then tag per the existing procedure. - **Credentials cheat-sheet**: agent identity, keychain service name (`gitea-claude-code`), Gitea PR API endpoint, base branch, and do-not-push warnings for `origin`/`upstream`. - **Fix typo**: repo slug is `gitmost`, not `gtimost` (the remote was redirecting on every push). Local `gitea` remote URL is updated to the canonical form. ## Out of scope No code changes — docs only.
Ghost added 1 commit 2026-06-20 04:18:35 +03:00
CLAUDE.md was the agent-guidance file; rename it to AGENTS.md (the
opencode-standard name) and prepend a process layer on top of the
existing technical/architecture content:

- Task lifecycle: sync with develop, branch off, implement, commit ONLY
  to Gitea and ONLY as claude_code, push + PR to develop, user merges,
  delete the backlog doc for the task
- Release cycle: before cutting a version, run three orchestrator skills
  (test-orchestrator, review-orchestrator, red-team-orchestrator), fix
  their findings, then cut the tag per the existing procedure
- Credentials cheat-sheet: agent identity, keychain service name for the
  password, Gitea PR API endpoint, base branch, and the origin/upstream
  do-not-push warnings

Also fixes a typo: the Gitea repo slug is 'gitmost', not 'gtimost'
(the remote URL was redirecting gitmost -> gitmost on every push). The
local gitea remote URL is updated to the canonical form as well.
vvzvlad merged commit ddb93525d6 into develop 2026-06-20 04:19:04 +03:00
vvzvlad deleted branch docs/rename-claude-md-to-agents-md 2026-06-20 04:19:04 +03:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: vvzvlad/gitmost#2