AGENTS.md
+ CLAUDE.md
ALWAYS LOADEDArchitecture, commands, conventions, hard constraints, and short pointers toward deeper context.
// NEW SKILL UNLOCKED
PRODUCT
CONTEXT
BUILDER
"the context architect"
Create the files that teach AI how your repository works, what your product should feel like, and when to reuse the design system you already built.
// THE PROBLEM
Your design system only works as well as the agent’s understanding of where it lives and when to use it.
A component library can be beautifully built and still drift the moment an agent starts shipping. The missing layer is usually the context around it: repository rules, product judgment, visual rules, and the workflows that should load only when the task calls for them.
// YOUR CONTEXT LOADOUT
FOUR FILES. FOUR DIFFERENT JOBS.
AGENTS.md
ALWAYS LOADEDPRODUCT.md
PRODUCT WORKUsers, purpose, personality, references, anti-references, and the principles behind the product.
DESIGN.md
UI WORKSource-of-truth tokens, typography, layout, components, states, and specific usage rules.
skills/
WHEN MATCHEDRepeatable workflows such as creating a PRD, documenting a component, or auditing token usage.
// HOW THE SYSTEM ROUTES
YOUDesign a new settings screen.
>ALWAYSAGENTS.md
>PRODUCTPRODUCT.md
UIDESIGN.md
IF MATCHEDskills/
The always-loaded file behaves like a switchboard. It keeps the session lean, then sends the agent deeper only when the work needs it.
// WHAT THE SKILL DOES
BUILD FROM THE REPO.
ADD JUDGMENT TOGETHER.
- 01
INSPECTS WHAT EXISTS
Finds real commands, architecture, components, Storybook stories, tokens, and existing context files.
- 02
ASKS FOR WHAT CODE CANNOT KNOW
Works through users, purpose, personality, references, anti-references, and product boundaries with you.
- 03
DRAFTS ONE FILE AT A TIME
Separates repository evidence, human decisions, and unresolved questions so every file can be reviewed properly.
- 04
CHECKS THE CONNECTIONS
Looks for duplication, contradictions, invented tokens, broken paths, and skills with descriptions too vague to trigger.
// READY PLAYER ONE?
BUILD THE CONTEXT LAYER FOR YOUR PRODUCT.
Leave your details and we’ll unlock the skill, templates, and install command.
// ACCESS GRANTED
ADD IT TO YOUR AGENT.
// INSTALL WITH NPX
npx skills add https://github.com/thedesignproject/agent-skills --skill product-context-builderThe npx command becomes live when this skill is added to the public TDP agent-skills repository. The ZIP works now for local testing.