---
name: pstack-domain
preamble-tier: 3
version: 0.1.0
description: |
  Create or update a domain doc. Domains are the long-lived layer above features.
  Use when asked to "create a domain", "update a domain", "/pstack-domain",
  or "new product surface".
triggers:
  - /pstack-domain
  - new domain
  - update domain
allowed-tools:
  - Bash
  - Read
  - Write
  - Edit
---

# pstack-domain

Create or update a domain doc in `docs/domains/`.

## Modes

### Create

1. Confirm name and owner.
2. Copy `${CLAUDE_SKILL_DIR}/../../templates/domain.md` to `docs/domains/<name>.md`.
3. Brainstorm to fill in: what it does, why it exists.
4. Leave "Shipped features" / "Planned" / "Known limitations" empty for now.
5. Print the path.

### Update

1. Read existing `docs/domains/<name>.md`.
2. Identify what's changing — new shipped feature, new known limitation, etc.
3. Edit only the relevant section. Preserve the rest.
4. Confirm with user before writing.

## Do not

- Do not commit. Domain doc updates often pair with feature/spec PRs and should
  be reviewed alongside them.
- Do not duplicate content across domains. If a feature touches multiple
  domains, mention it in each but keep authoritative content in one.
