Repository navigation
docs(agents): plan, build and review sessions per issue, and a short-output check script - #25
Merged
Merged
Conversation
During issue #6, repeated ENDOFLINE listings and full test logs filled the agent's context, and every line is paid again on each reply. The script fixes the formatting first, builds quietly, and prints the whole test output only when a test fails, as the evidence of a Red.
Records the workflow agreed after issue #6: a plan session that ends with a plan comment on the issue (decisions and the test list with the expected result of each test), a build session that follows it, and a review session in a new conversation before the owner merges. The owner's guide says which model and effort to use in each one. AGENTS.md makes check.ps1 the default command, asks for short tool output, and treats a failed planned approach as a stop point. The TDD workflow commits before each pause.
MendesMat
enabled auto-merge (squash)
September 28, 2026 05:40
MendesMat
disabled auto-merge
September 28, 2026 05:40
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Documents how an issue is worked on with agents after the lessons of issue #6, and adds
check.ps1, a single command that formats, builds and tests with short output.Why
Issue #6 showed three problems:
ENDOFLINElistings and full test logs filled it, and every line is paid again on each reply.What changes
docs/agents/workflows/implement-a-feature.md, section Sessions and new step 9):docs/agents/trabalhando-com-agentes.md, in Portuguese): which model and effort to use in each session, what to paste to start each one, when to use pair or autonomous mode, when to switch models, and how to watch the quota.check.ps1(backend/ControlService): runsdotnet format, then the build, then the tests. It prints only problems and summaries, and keeps the whole test output when a test fails, as the evidence of a Red. It replaces the separate commands inAGENTS.md, the testing guide, the git workflow and the backend README.AGENTS.md: asks for short tool output, and treats a failed approach from the approved plan as a stop point.How to test
Checked on three runs:
The relative links of every changed document resolve.
Checklist
dotnet test --solution ControlService.slnxpasses locallyAGENTS.md,docs/agents/, backend README)