Skip to content

Remove kit documentation files and consolidate agent guidance#4

Merged
chloeilabs merged 1 commit into
mainfrom
claude/review-agents-skills-r5v0h
Apr 17, 2026
Merged

Remove kit documentation files and consolidate agent guidance#4
chloeilabs merged 1 commit into
mainfrom
claude/review-agents-skills-r5v0h

Conversation

@chloeilabs
Copy link
Copy Markdown
Owner

Summary

This PR removes standalone kit documentation files from .agents/skills/ and consolidates agent guidance into the main AGENTS.md files and docs/agents/ directory. The kit files (code-review-5pass, autonomous-improve, project-scaffold, codebase-map, systematic-debugging) and repo-specific skill files (repo-review, copilot-workflow, markets-workflow) are being deprecated in favor of a more centralized documentation structure.

Key Changes

  • Removed kit documentation: Deleted 5 comprehensive kit files from .agents/skills/:

    • code-review-5pass/kit.md (5-pass code review methodology)
    • autonomous-improve/kit.md (quality improvement loop)
    • project-scaffold/kit.md (convention-aware file generation)
    • codebase-map/kit.md (structural codebase indexing)
    • systematic-debugging/kit.md (root cause debugging protocol)
  • Removed repo-specific skill files: Deleted 3 workflow skill definitions:

    • .agents/skills/repo-review/SKILL.md
    • .agents/skills/copilot-workflow/SKILL.md
    • .agents/skills/markets-workflow/SKILL.md
  • Updated documentation references: Modified guidance files to remove references to .agents/skills/* paths:

    • AGENTS.md: Removed mention of .agents/skills/* as a location for long playbooks
    • src/lib/server/markets/AGENTS.md: Updated architecture reference path
    • README.md: Removed reference to skill-based workflows
    • docs/agents/repo-map.md: Removed mention of skill files in repo structure

Implementation Details

The consolidation maintains all guidance content by directing users to:

  • Root AGENTS.md for repo-wide contracts
  • Nested AGENTS.md files for subtree-specific rules
  • docs/agents/* and docs/architecture/* for detailed playbooks and background

This simplifies the agent guidance structure by eliminating the intermediate .agents/skills/ layer while preserving all essential information in more discoverable locations.

https://claude.ai/code/session_01XpZuDmX2U6PezgJ1eLvmaR

The five kit.md directories used a non-standard schema not recognized by
Claude Code's skills loader, and the three SKILL.md directories were not in
the auto-discovered .claude/skills/ path. Content overlapped heavily with
AGENTS.md and docs/agents/*, so drop the directory entirely and clean up
incoming references.
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 17, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
finance Ready Ready Preview, Comment Apr 17, 2026 2:36am

Request Review

@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@chloeilabs chloeilabs merged commit 5f7d6c7 into main Apr 17, 2026
5 checks passed
@chloeilabs chloeilabs deleted the claude/review-agents-skills-r5v0h branch April 17, 2026 02:38
chloeilabs added a commit that referenced this pull request Apr 17, 2026
…e-page-2.tsx-files

Remove obsolete duplicate `page 2.tsx` route files
chloeilabs added a commit that referenced this pull request Apr 17, 2026
Remove kit documentation files and consolidate agent guidance
chloeilabs added a commit that referenced this pull request Apr 17, 2026
…e-page-2.tsx-files

Remove obsolete duplicate `page 2.tsx` route files
chloeilabs added a commit that referenced this pull request Apr 17, 2026
Remove kit documentation files and consolidate agent guidance
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.

2 participants