Skip to content

docs: document the feedback-driven agent workflow - #25

Merged
fengzhi09 merged 1 commit into
mainfrom
docs/agent-workflow
Sep 25, 2026
Merged

fengzhi09 merged 1 commit into
mainfrom
docs/agent-workflow

Conversation

@fengzhi09

Copy link
Copy Markdown
Collaborator

What

Documents the agreed feedback-driven agent workflow in AGENTS.md and gives it a private home for tickets:

  • Clarify (grill-me) — one-question-at-a-time interviews for under-specified feedback
  • Record (to-tickets) — tracer-bullet tickets under .tickets/<feature-slug>/, with blocking edges and acceptance criteria
  • Implement — one development subagent per ticket (minimax-cn/MiniMax-M3), own branch, parallel when unblocked
  • Accept — independent acceptance subagent (zai-coding-cn/GLM-5.3-Flash): diff review vs acceptance criteria, targeted gates, browser + screenshot verification for UI changes
  • Ship — PR with acceptance report attached, squash auto-merge once CI is green

Supporting changes: .gitignore ignores .tickets/; scripts/source-inventory.mjs skips .tickets so local tickets never enter the published source inventory.

Verification

  • pnpm check:source — pass (4556 files; verified .tickets/ content is excluded)
  • pnpm test:release-tools — 51 pass, 0 fail
  • Dev server smoke: pnpm webui:dev backend on 18090 + frontend on 18091 both up

Full pnpm verify deferred to CI per the workflow being documented.

Add an AGENTS.md section fixing the clarify/record/implement/accept/ship
pipeline: grill-me interviews for under-specified feedback, to-tickets
tracer-bullet tickets under the private .tickets/ directory, MiniMax-M3
development subagents, independent GLM-5.3-Flash acceptance with targeted
gates and browser verification, and squash auto-merge PRs.

Ignore .tickets/ and exclude it from the source inventory scan so local
tickets never leak into the published source list.
@fengzhi09
fengzhi09 enabled auto-merge (squash) September 25, 2026 13:17
@fengzhi09
fengzhi09 merged commit db27522 into main Sep 25, 2026
8 checks passed
@fengzhi09
fengzhi09 deleted the docs/agent-workflow branch September 25, 2026 15:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant