[PR #736] [MERGED] docs(agents): clarify architecture-first workflow #748

New issue

Closed

opened 2026-02-26 22:32:23 +03:00 by kerem · 0 comments

kerem commented

2026-02-26 22:32:23 +03:00

Owner

📋 Pull Request Information

Original PR: https://github.com/rudrankriyam/App-Store-Connect-CLI/pull/736
Author: @rudrankriyam
Created: 2/23/2026
Status: ✅ Merged
Merged: 2/23/2026
Merged by: @rudrankriyam

Base: main ← Head: chore/remove-1-0-readiness-guardrail

📝 Commits (1)

49d7f7b docs(agents): clarify architecture-first workflow

📊 Changes

1 file changed (+43 additions, -7 deletions)

View changed files

📝 AGENTS.md (+43 -7)

📄 Description

Summary

Refine existing AGENTS.md wording to emphasize reviewer ownership, explicit long-form flags in docs/tests, and --help-first command discovery.
Consolidate key testing language (single canonical keychain bypass rule), tighten TDD/debugging expectations, and make the Definition of Done more auditable.
Add architecture/process guardrails for agent-driven work: operating mode, command lifecycle and compatibility, explainability contract, and parallel agent policy.

Test plan

Pre-commit checks passed during commit (format, lint, and short test suite).
Verified AGENTS.md changes render as expected in markdown structure.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/rudrankriyam/App-Store-Connect-CLI/pull/736 **Author:** [@rudrankriyam](https://github.com/rudrankriyam) **Created:** 2/23/2026 **Status:** ✅ Merged **Merged:** 2/23/2026 **Merged by:** [@rudrankriyam](https://github.com/rudrankriyam) **Base:** `main` ← **Head:** `chore/remove-1-0-readiness-guardrail` --- ### 📝 Commits (1) - [`49d7f7b`](https://github.com/rudrankriyam/App-Store-Connect-CLI/commit/49d7f7b0dcdd0c4f3a17da3dfe47f6e42f26abcd) docs(agents): clarify architecture-first workflow ### 📊 Changes **1 file changed** (+43 additions, -7 deletions) <details> <summary>View changed files</summary> 📝 `AGENTS.md` (+43 -7) </details> ### 📄 Description ## Summary - Refine existing `AGENTS.md` wording to emphasize reviewer ownership, explicit long-form flags in docs/tests, and `--help`-first command discovery. - Consolidate key testing language (single canonical keychain bypass rule), tighten TDD/debugging expectations, and make the Definition of Done more auditable. - Add architecture/process guardrails for agent-driven work: operating mode, command lifecycle and compatibility, explainability contract, and parallel agent policy. ## Test plan - [x] Pre-commit checks passed during commit (format, lint, and short test suite). - [x] Verified `AGENTS.md` changes render as expected in markdown structure. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>