TEACH
YOUR AGENT.
@domain-first/project-structure
Give Claude Code or Codex the Domain First workflow. Agent skills plan features, scaffold components with df-ps and implement the generated code without breaking the project structure.
Copy the skills into your project.
The skills ship with Project Structure. Install the package, then run df-skills from the project root.
npm install --save-dev @domain-first/project-structurenpx df-skillsChoose the agents to install for and whether the skills go into the current project or into your home directory. Commit project skills to share them with the team.
One set of skills. Two agents.
Both agents read the same SKILL.md format, so the skills are copied unchanged. Pass flags to skip the prompts, for example in a setup script.
--claudeInstalls for Claude Code into .claude/skills.
--codexInstalls for Codex into .agents/skills.
--globalInstalls into the home directory instead of the current project.
.claude/skills/
df-ps-plan-feature/
df-ps-scaffold/
df-ps-implement/
df-ps-project-scripts/
.agents/skills/
# the same four skillsFrom a feature request to working code.
The agent picks a skill on its own when the project has domain-first.project-structure.config.json and the request matches. You can also name a skill explicitly.
df-ps-plan-featureTurns an abstract request such as “let users cancel orders” into a plan: which bounded contexts own what and which components are needed. Nothing is generated before you approve the plan.
df-ps-scaffoldGenerates bounded contexts, aggregates, repositories, use cases, endpoints, React modules and more through the df-ps CLI. New files and new dependencies appear only through df-ps.
df-ps-implementFills in the generated placeholders: entities and value objects, handler schemas, errors, wiring, REST endpoints, React modules and tests. Checks that bounded contexts stay isolated.
df-ps-project-scriptsRuns the project’s own package.json scripts: Prisma contract emit, migration planning and applying, other codegen. The agent uses your scripts instead of calling the underlying CLIs directly.
Before creating files, the agent shows a work plan and waits for your approval. Planning, scaffolding and implementing remain separate, reviewable steps.
Upgrade the package, refresh the skills.
Skills evolve together with the CLI. After upgrading Project Structure, run df-skills again: existing df-ps-* folders are replaced with the new versions, and your other skills are left untouched.
npx df-skills --claude --codexWithout installing the package, run npx -p @domain-first/project-structure df-skills. Continue with the scaffolder ↗ to see every component the agent can generate.