Skip to content

chore: agent-agnostic standards, workflows, and skill optimization#2366

Draft
TC-MO wants to merge 3 commits intochore/strengthen-vale-toolingfrom
chore/agent-agnostic-standards-and-workflows
Draft

chore: agent-agnostic standards, workflows, and skill optimization#2366
TC-MO wants to merge 3 commits intochore/strengthen-vale-toolingfrom
chore/agent-agnostic-standards-and-workflows

Conversation

@TC-MO
Copy link
Contributor

@TC-MO TC-MO commented Mar 24, 2026

Draft - writeup pending

Summary

  • Move .claude/rules/standards/ at repo root (agent-agnostic)
  • Extract workflows and references from .claude/skills/workflows/ at repo root
  • Rewrite all 4 skills as summary + pointer adapters with AgentSkills spec compliance
  • Peg review-docs to Sonnet with hybrid subagent approach (eval-driven decision)
  • Delete Cursor symlinks, rewrite .mdc files as thin pointers
  • Add lint ignores for agent-facing infrastructure files

Depends on #2365

🤖 Generated with Claude Code

TC-MO and others added 3 commits March 24, 2026 14:01
Move .claude/rules/ to standards/ at repo root so all agents have
parity. Replace verbose style sections in AGENTS.md with condensed
summary + pointers. Trim standards where Vale now enforces the check.
Add information ordering principle. Update symlinks, supporting files,
and lint ignores.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Move workflow processes and references from .claude/skills/ to
workflows/ at repo root for agent parity. Rewrite all 4 SKILL.md
files as summary + pointer adapters with AgentSkills spec compliance.
Delete Cursor symlinks, rewrite .mdc files as thin pointers.
Add check-frontmatter.sh script and workflows section to AGENTS.md.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Eval showed Sonnet hybrid (summary + pointer adapter with delegated
standards subagents) is the best tradeoff: ~80% cheaper than old Opus
approach, 4% faster, and catches more issues. Deterministic tools run
in main process (no sandbox issues), subagents handle standards review.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@TC-MO TC-MO self-assigned this Mar 24, 2026
@TC-MO TC-MO added the t-docs Issues owned by technical writing team. label Mar 24, 2026
@apify-service-account
Copy link

Preview for this PR was built for commit 3e122baa and is ready at https://pr-2366.preview.docs.apify.com!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

t-docs Issues owned by technical writing team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants