deferred-capture

Night Market Skill — ported from claude-night-market/leyline. For the full experience with agents, hooks, and commands, install the Claude Code plugin.

Deferred Capture Contract

When To Use

• Building a new plugin deferred-capture wrapper
• Validating an existing wrapper against the contract
• Adding new source labels or template fields

When NOT To Use

• Capturing a deferred item at runtime (use the plugin wrapper directly, e.g. scripts/deferred_capture.py)
• Creating GitHub issues manually

Specification that all plugin deferred-capture wrappers implement. Not a runtime dependency -- a convention.

CLI Interface

Required arguments:

• --title (str): Concise description. Becomes issue title after [Deferred] prefix
• --source (str): Origin skill. One of: war-room, brainstorm, scope-guard, feature-review, review, regression, egregore
• --context (str): Why raised and why deferred

Optional arguments:

• --labels (str): Comma-separated additional labels beyond deferred and source
• --session-id (str): Session ID. Canonical source: $CLAUDE_SESSION_ID env var, fallback: UTC timestamp YYYYMMDD-HHMMSS
• --artifact-path (str): Absolute path or $HOME-based path to source artifact
• --captured-by (str): explicit (default) or safety-net
• --dry-run (flag): Print JSON output without creating issue

Issue Template

Title: [Deferred]

Labels: deferred and ``

Body:

## Deferred Item

**Source:**  (session )
**Captured:** 
**Branch:** 
**Captured by:** 

### Context



### Original Artifact



### Next Steps

- [ ] Evaluate feasibility in a future cycle
- [ ] Link to related work if applicable

Label Taxonomy

Duplicate Detection

Search: gh issue list --search " in:title" --state open --json number,title

Compare: exact title match after stripping [Deferred] prefix and normalizing to lowercase.

Only open issues are checked. Re-filing a closed deferred item is intentional.

Output (JSON to stdout)

Created: {"status": "created", "issue_url": "...", "number": 42} Duplicate: {"status": "duplicate", "existing_url": "...", "number": 17} Error: {"status": "error", "message": "..."}

Compliance Test

Any wrapper can verify conformance with:

python3 scripts/deferred_capture.py \
  --title "Test: compliance check" \
  --source test \
  --context "Automated compliance verification" \
  --dry-run

Must output valid JSON with a status field.