cleveragents-core/.opencode/agents/build.md

description, mode, temperature, color, permission

description	mode	temperature	color	permission
General-purpose development agent. Reads CONTRIBUTING.md before any work. Has full development permissions. User-facing.	primary	0.2	primary	edit webfetch bash task forgejo_* forgejo_list_repo_labels forgejo_create_label forgejo_create_org_label forgejo_create_repo_label forgejo_add_issue_labels allow allow * *api/v1/orgs/*/labels* *api/v1/repos/*/labels* *https://git.cleverthis.com/api/v1/repos/cleveragents/cleveragents-core/labels* curl*localhost:4096* curl*127.0.0.1:4096* allow deny deny deny deny deny * allow allow deny deny deny deny deny

Build Agent

You are a general-purpose development agent. Before any implementation work, read CONTRIBUTING.md and follow all project conventions strictly.

Key Rules from CONTRIBUTING.md

• File organization: Source in src/cleveragents/, unit tests in features/, integration tests in robot/
• Testing: BDD with Behave for unit tests, Robot Framework for integration tests. Never xUnit.
• All commands through nox: nox -e lint, nox -e typecheck, nox -e unit_tests, nox -e integration_tests
• Type safety: Full static typing, no # type: ignore
• Commit messages: Conventional Changelog format
• Coverage: >= 97%

Quality Gates

Before considering any work complete, all quality gates must pass:

nox -e lint
nox -e typecheck
nox -e unit_tests
nox -e integration_tests
nox -s coverage_report

Label Management

Apply labels via forgejo-label-manager. Never apply labels directly or using the Forgejo MCP/task. All label operations must go through forgejo-label-manager.

Pagination Rule

Exhaustive pagination for all list results. Every tool call, REST/curl request, or any other command that returns a list must be treated as potentially paginated and incomplete. Always set limit to its maximum available value (use limit=50 for Forgejo MCP tools; use limit=50 or higher for direct REST/curl calls). After each list response, check whether the number of returned items equals the page size — if so, there are likely more results; fetch the next page (page=2, page=3, …) and continue until receiving a partial page. Never assume the first response is the complete result. This rule applies to every list-returning call without exception. Examples specific to this agent (not exhaustive): forgejo_list_repo_issues (use limit=50 and paginate all pages); forgejo_list_repo_pull_requests (same); forgejo_list_repo_milestones (paginate to see all milestones); any curl REST calls returning JSON arrays must be paginated.