deft-directive-xbrief · diff
git:20260806.cadf997 to git:20260924.0a2af4b
3 added, 0 removed. Audit A to A.
---
name: deft-directive-xbrief
description: >-
Create and verify dense xBRIEF artifacts (json|md|both) at an explicit --out
path. On-demand pack templates for scope/playbook/mission/project styles.
Use when compressing SoT into xBRIEF or running xbrief:create /
xbrief:verify. Do NOT trigger on scope lifecycle
(promote/activate/complete).
triggers:
- xbrief create
- xbrief verify
- create xbrief
- verify xbrief
- compress into xbrief
- xbrief:create
- xbrief:verify
+ - xbrief:adopt-stored-plan-id
---
<!-- AUTO-GENERATED by task packs:render -- DO NOT EDIT MANUALLY -->
<!-- Purpose: rendered skill -->
<!-- Source of truth: packs/skills/skills-pack-0.1.json -->
<!-- Regenerate with: task packs:render -->
<!-- Edit the source, not this file. Slice instead of loading every SKILL.md: task packs:slice skills by-trigger --trigger <kw> (or list) -->
# Deft Directive xBRIEF — on-demand create/verify
Create and verify dense xBRIEF artifacts (json|md|both) at an explicit path. Pack templates load on use — not an always-on novel.
Legend (from RFC2119): !=MUST, ~=SHOULD, ≉=SHOULD NOT, ⊗=MUST NOT, ?=MAY.
## When to Use
- Need a dense SoT brief (scope, playbook, mission, project) without freestyling long prose
- Operator or agent says `xbrief create`, `xbrief verify`, or `compress into xbrief`
- ⊗ Scope lifecycle work (promote / activate / complete) — use scope:* / intake instead
## How (CLI)
```bash
deft xbrief:create -- --format <json|md|both> --out <path> [--style scope|playbook|mission|project] [--title T] [--id ID] [--force]
deft xbrief:verify -- --format <json|md|both> --out <path> [--style scope|playbook|mission|project]
+ deft xbrief:adopt-stored-plan-id -- --out <path> [--project-root <dir>]
```
- ! `--format` and `--out` are **required**
- ! `both` writes a stem pair: `*.xbrief.json` + `*.xbrief.md`
- ! Paths expand portably (`~`, `%USERPROFILE%`); writes stay under project root (fail closed)
- ! create/verify **do not** move lifecycle folders
## Pack on use
- ~ Full grammar + templates: `task packs:slice skills by-trigger --trigger xbrief` (or this skill path)
- ~ Schema spine: `content/vbrief/schemas/xbrief-core-0.8.schema.json`
- ⊗ Dump pack novels into always-on bootstrap or into SoT artifacts
## Create vs lifecycle
| Verb | Meaning |
|------|---------|
| `xbrief:create` / `xbrief:verify` | Write or check an artifact at `--out` |
+ | `xbrief:adopt-stored-plan-id` | Copy the stored `x-directive/plan-id` id onto `plan.id` and a paired markdown frontmatter id. Refuses when that id already occupies another artifact. |
| `scope:*` / intake | Lifecycle birth and folder/status transitions |
| `xbrief:preflight` | Implementation-intent gate (unchanged) |
## Token budget
- ! Keep this skill postcard-sized; load pack/CLI help only when creating or verifying
- ⊗ Inline full schema manuals or multi-style novels into the always-on body
## Anti-Patterns
- ⊗ Overload `scope:promote` (or any lifecycle verb) to mean "compress text"
- ⊗ Invent `xbrief:promote` for create
- ⊗ Escape project root with `--out`
- ⊗ Auto-write to personal memory stores from this skill
## Exit
deft-directive-xbrief complete — create/verify done; chain to scope:* only when lifecycle is intended.