Imported from devstationtech/devstation (
AGENTS.md). Install upstream withnpx skills add devstationtech/devstation. Copyright stays with the author.
AGENTS.md
Entry point for AI agents working in this repository. Generated by harness from the artifacts selected for this project.
Loading protocol
Read this section first, then load artifacts according to these rules:
- Rules — load ALWAYS. Rules are project invariants (language, directory structure, where configuration and environment variables live, naming, etc.). Load every rule listed below before doing any work and treat them as non-negotiable constraints.
- Skills — load on NEED. Skills are on-demand capabilities. Read a skill's document only when the current task matches its description (progressive disclosure) so you do not waste context on capabilities you will not use.
- Agents — delegate on NEED. Agents are specialized executors. Delegate to one when its description fits the task.
- MCPs — set up on NEED. MCP entries wire an external tool server into the coding agents that support it. When the user asks to enable one, read its document and run the setup script it points to for the chosen tool(s).
- Specs live in
.agents/specs/, one directory per spec. Consult the relevant spec before implementing the feature it describes.
Rules — load ALWAYS
| Rule | Description | Source | Path |
|---|---|---|---|
code-standards |
The non-negotiable invariants for the DevStation CLI — stack, hexagonal + tactical-DDD + CQRS layering, bounded-context isolation, object-oriented conventions, file/class/method naming, import-map aliases, error handling, domain events, React Ink view rules, and test conventions. These are fixed structures that hold for every activity. Always load and apply when writing, refactoring, or reviewing any code in this repository. | local | .agents/rules/code-standards/RULE.md |
Skills — load on NEED
| Skill | When to use | Source | Path |
|---|---|---|---|
blueprint-dsl |
Author or change a service blueprint — the declarative YAML DSL (blueprints//blueprint.yaml, or user-local via devstation blueprint register). Standalone vs hosted shapes, steps with verify/publish/rollback, uninstall, shell templating, ${file:} sidecars, version-bump policy, and validation against the strict parser. Use when adding or changing a blueprint; NOT for engine/UI code (use low-level-design). |
local | .agents/skills/blueprint-dsl/SKILL.md |
contributing |
How to ship a change to DevStation — Conventional Commit format with BC scopes, the full CI quality gate (audit, smoke compile and Sonar beyond fmt/lint/check/test), what CI does NOT run (MCP e2e, mutation), the branch model, and the release procedure (version bump rules, tag mechanics, artifacts, anti-drift invariants, the three version namespaces). Use when committing, opening a PR, cutting a release, or bumping any version field. | local | .agents/skills/contributing/SKILL.md |
low-level-design |
End-to-end playbook for a DevStation feature slice — OpenRPC contract + codegen, Ink UI (screen, form, integration, provider wiring), domain modeling (aggregates, entities, VOs, events, ports), commands/handlers, query read models, inbound RPC/MCP, outbound adapters, policies, composition root, and the tests for each layer. Use when creating or modifying any feature slice or its tests; read only the reference(s) matching the layers you touch. | local | .agents/skills/low-level-design/SKILL.md |
Agents — delegate on NEED
No agents selected yet.