Skip to content

feat: rebuild the shipped AGENTS.md and preset skills - #24

Merged
Tanq16 merged 11 commits into
mainfrom
feat/agents-principles
Aug 18, 2026
Merged

Tanq16 merged 11 commits into
mainfrom
feat/agents-principles

Conversation

@Tanq16

@Tanq16 Tanq16 commented Aug 17, 2026 •

Copy link
Copy Markdown
Owner

Replaces the AGENTS.md content ClaudeX ships, splits it by whether a rule is portable or personal, trims the base skill set, and rebuilds the preset's skills as single-subject skills.

AGENTS.md

  • internal/embedded/agents/AGENTS.base.md carries Prose/Output Principles only, so every claudex apply gets the portable half.
  • The development preset is renamed private, and its AGENTS.partial.md carries Development Principles, Pull Request Principles, and Operating Principles.
  • Operating Principles moved out of the base because it states host facts ($HOME/shell/extensions/, the uv and fnm environment variables) that are true on one machine only.
  • Prose/Output Principles gains a rule against progress narration, covering openers, bridges between steps, and step closers.

Skills

  • cross-ai is removed. The base set is skill-creator and session-summary.
  • The preset's 13 skills and 32 reference files become 30 skills and 6 reference files, all six under review-code where a sub-agent is handed the path directly. Set size drops from ~426,000 to ~292,000 characters, and the floor cost of any Go task halves.
  • go-foundations, go-cli, go-backend, go-frontend, go-concurrency, node-foundations, node-backend, and project-ci-cd are split by subject. dockerize is new and language-agnostic, covering multi-stage builds, base image choice, runtime packaging, cache clearing, and a non-root user.
  • develop's Skill Map and review-code's six domains are re-cut to the new set.
  • Every body is under the 4,500-token budget; the largest is go-oauth-cli at ~3,420.

Standardizations applied across the set

  • Releases trigger on push to main. The version is computed by the Makefile and the workflow calls make -s version, so CI and a laptop produce the same number. Tag-push triggering is documented nowhere.
  • Assets are never committed. make downloads them and CI calls the same target.
  • Every dependency and action is version-pinned to a tag that was checked against the upstream releases, never floating and never commit-pinned.
  • Terminal colors are ANSI indexed, never hex, so tooling follows the user's terminal theme.
  • Web fonts are woff2 only. Inter, Google Sans, and JetBrains Mono Nerd Font Mono are always downloaded; the Nerd Font is converted from ttf by a recipe both Makefiles share.
  • The review domain files lose their "Expected Pattern" column. review-code now states the rule that replaces it: the expected pattern lives in the skill the domain names, and a finding cites the skill section it comes from.

Nuances

  • chrome-extension-basics is renamed chrome-extension, and go-dockerfile never lands because its material went to dockerize.
  • go-embedded-frontend moves to Tailwind v4. The v3 CDN is frozen and the v4 browser build throws on a JS config, so the old tailwind.config global produced no CSS.
  • Section order in an assembled AGENTS.md is Prose/Output, then Development, Pull Request, Operating.
  • The preset name is the marker name, so a project that already applied development keeps a <!-- claudex:preset:development --> block.
  • Flavors are removed entirely: the internal/flavors package, the --flavor and --no-flavor launch flags, the launch-time picker, and the ~/.config/claudex/flavors directory configure used to create. An existing flavors directory is left on disk untouched.
  • skills_gate_test.go and utils/paths_test.go are removed. internal/workspace keeps the only test file, covering the AGENTS.md marker states and the git exclude anchoring.
  • The README is rewritten to the shipped prose principles.
  • .github/workflows/notifications.yaml is deleted. release.yaml is the only workflow left.

🤖 Generated with Claude Code

@Tanq16 Tanq16 changed the title feat: replace the shipped AGENTS.md content with the principle sets feat: replace the shipped AGENTS.md content and split it into base and private Aug 18, 2026
@Tanq16 Tanq16 changed the title feat: replace the shipped AGENTS.md content and split it into base and private feat: rebuild the shipped AGENTS.md and preset skills Aug 18, 2026
@Tanq16
Tanq16 merged commit f792e6e into main Aug 18, 2026
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