chore: add shared skills from epicenter and revamp AGENTS.md#91
Merged
chore: add shared skills from epicenter and revamp AGENTS.md#91
Conversation
Symlink 18 AI agent skills from the epicenter repo via relative cross-repo symlinks. Epicenter is the source of truth for skill definitions; wellcrafted consumes them to stay in sync. Structure: .agents/skills/<name> → ../../../epicenter/.agents/skills/<name> .claude/skills/<name> → ../../.agents/skills/<name> Both repos must be sibling directories under the same parent. Documents the peer directory requirement in README.md.
Create concise AGENTS.md (10 lines) following context engineering best practices: WHAT (library purpose), structure, HOW (tooling), and skills pointer. No style rules (covered by typescript skill), no setup details (covered by README.md). CLAUDE.md now just references AGENTS.md, matching epicenter's pattern.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Wellcrafted and Epicenter share a lot of coding conventions, but until now there was no way for an agent working in wellcrafted to access those conventions. This meant every session started from scratch—no knowledge of error handling patterns, TypeScript style, commit conventions, or any of the other skills we've built up in Epicenter.
This PR symlinks 18 skills from Epicenter into wellcrafted using relative cross-repo symlinks. Epicenter remains the single source of truth; edits happen there and propagate automatically. The symlink chain is two levels deep:
This requires both repos to be sibling directories under the same parent, which is documented in a new "Development Setup" section in
README.md.The PR also restructures agent instructions to match Epicenter's pattern and follow context engineering best practices.
CLAUDE.mdis now a single-line@AGENTS.mdreference.AGENTS.mdis 10 lines covering WHAT (library purpose), structure, HOW (bun/biome/tsc commands), and a pointer to skills. No style rules—those live in thetypescriptskill where they belong. No setup details—those live inREADME.mdvia progressive disclosure.Skills imported: error-handling, typescript, factory-function-composition, control-flow, honesty, documentation, git, writing-voice, method-shorthand-jsdoc, single-or-array-pattern, specification-writing, workflow, incremental-commits, progress-summary, services-layer, query-layer, typebox, frontend-design.