Skip to content

refactor(agents): compact classic guidance - #35

Merged
zoeyrose merged 3 commits into
mainfrom
docs/issue-294-agent-guidance
Aug 9, 2026
Merged

refactor(agents): compact classic guidance#35
zoeyrose merged 3 commits into
mainfrom
docs/issue-294-agent-guidance

Conversation

@zoeyrose

@zoeyrose zoeyrose commented Aug 9, 2026

Copy link
Copy Markdown
Member

Summary

  • Compact the classic root and server guidance, move detailed MAP2 and lighting rules to a focused design reference, and correct runtime/protocol skill commands.
  • Retire 27 inert nested workflow, Dependabot, and semantic-release copies after validating unified root ownership and release history.
  • Link this owning-repository change to Agent guidance: remove stale instructions and cut routine context cost atrinik#294.

Validation

  • Imported-history verifier and 92 root tests
  • Protocol and libatrinik CMake/CTest
  • Semantic-release tests, ShellCheck, Actionlint, and profile-aware supply-chain audit
  • git diff --check

@codecov

codecov Bot commented Aug 9, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@zoeyrose

zoeyrose commented Aug 9, 2026

Copy link
Copy Markdown
Member Author

Deep self-review added an explicit regression test preventing retired nested workflow and Dependabot surfaces from returning. Imported history, 92 root tests, native builds, release tests, Actionlint, ShellCheck, and the profile-aware supply-chain audit pass; no open finding remains.

@zoeyrose
zoeyrose merged commit 31fe65e into main Aug 9, 2026
18 checks passed
@zoeyrose
zoeyrose deleted the docs/issue-294-agent-guidance branch August 9, 2026 00:31
zoeyrose added a commit to atrinik/atrinik that referenced this pull request Aug 9, 2026
## Summary

- Make root AGENTS a durable ownership and safety router, preserve the
new preview-first cleanup contract from #293, and establish
docs/PROVENANCE.md as the canonical grant registry.
- Split the multi-repository migration procedure into an on-demand
reference, remove unconditional broad reads, correct stale
C/protocol/content/runtime/scenario routes, and shrink discovery
metadata.
- Add a dependency-free guidance inventory with byte ceilings and tests
for budgets, local pointers, canonical provenance, and stale-route
regressions.

## Exact o200k_base results

Counts are repository-owned text, excluding chat/tool envelopes. Prompt
cases were cross-checked with codex debug prompt-input; ordinary-root
catalog paths are normalized from the review-worktree path.

| Scenario | Issue baseline | Final | Reduction |
| --- | ---: | ---: | ---: |
| Wrapper startup | 2,819 | 1,557 | 44.8% |
| Wrapper + multi-repository skill | 7,002 | 2,905 | 58.5% |
| Wrapper + multi + runtime + scenario | 8,339 | 3,572 | 57.2% |
| Standalone classic/server startup | 3,474 | 1,751 | 49.6% |
| Skill catalog at ordinary wrapper root | 575 | 354 | 38.4% |

Replacement AGENTS raw-text counts are client 1,918 to 975; server 2,501
to 967; protocol 2,643 to 987; editor 2,155 to 859; renderer 2,046 to
883; content-toolkit 1,918 to 763; and website 1,914 to 858.

## Coordinated owning-repository PRs

- atrinik/client#48
- atrinik/server#73
- atrinik/protocol#19
- atrinik/editor#21
- atrinik/renderer#27
- atrinik/content-toolkit#15
- atrinik/website#13
- atrinik/classic#35
- atrinik/content#54 (main)
- atrinik/content#53 (1.x)

## Validation

- 267 wrapper tests under coverage; 77% combined statement/branch
coverage
- compileall, manifest validation, all seven skill validators, guidance
inventory, cleanup dry-run, and git diff --check
- profile-aware supply-chain audit with the classic review worktree and
clean current tools checkout
- complete validators in every replacement and content checkout; classic
import/root/release/protocol/libatrinik/ShellCheck/Actionlint validation

Coordinates #294. Runtime launch is not applicable to
guidance-only orchestration changes; component build, packaging, GPU,
content collection, and policy paths were validated in their owning
repositories.
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