alexpialetski

alexpialetski/doccraft

Command Claude Code

Implement tasks from an OpenSpec change (Experimental).

alexpialetski/doccraft

Command Claude Code

Archive a completed change in the experimental workflow.

alexpialetski/doccraft

Command Claude Code

Enter explore mode - think through ideas, investigate problems, clarify requirements.

alexpialetski/doccraft

Command Claude Code

Propose a new change - create it and generate all artifacts in one step.

alexpialetski/doccraft

Skill Claude CodeCodex

Author or update architecture decision records (a.k.a. ADRs, design decisions, architecture decision log entries) under docs/adr/ as NNN-kebab-case.md with Nygard-style Context, Decision, Consequences, and an explicit Status. Use whenever the user is recording a new decision, superseding an old one, capturing a…

alexpialetski/doccraft

Skill Claude CodeCodex

Close a story end-to-end — flip its status to a terminal value and reconcile every downstream artifact in one pass: the backlog Status cell, the docs/queue.md row, the parent epic table (when the project uses epics), then a queue-audit reconcile. Use whenever the user says "close", "mark done", "ship", "finish"…

alexpialetski/doccraft

Skill Claude CodeCodex

Configure doccraft for this project by tailoring doccraft.json — the vocabulary, id format, queue labels, and session-wrap settings. Two modes: Analyse mode reads the project tree and proposes values for all key fields with reasoning, applying on approval; Edit mode applies a targeted change (e.g. "add…

alexpialetski/doccraft

Skill Claude CodeCodex

Reconcile the dependency graph, pick-next queue, and backlog status across docs/stories/, docs/queue.md, and docs/backlog.md. Use after adding or editing a story (especially one with dependson), after reshuffling priorities, or when the user asks "what can I work on next", "what's unblocked", "sanity-check the queue"…

alexpialetski/doccraft

Skill Claude CodeCodex

After a design, research, business, or prioritisation thread, evaluate whether the conversation produced durable insight worth capturing in docs/, then propose only the artifacts that are clearly justified (ADR, research note, reference doc, business update, story, backlog/queue edit). Use when the user says "wrap…

alexpialetski/doccraft

Skill Claude CodeCodex

Author or update product stories (a.k.a. planning docs, backlog items, tickets, specs) as Markdown under docs/stories/ with a YAML frontmatter contract (id, status, impact, urgency, dependson, tags, openspec). Use this whenever the user is creating a story, reprioritising work, writing acceptance criteria, linking a…

alexpialetski/doccraft

Skill Claude CodeCodex

Update the installed doccraft skills and openspec instructions to the latest release. Reads the version stamp from doccraft.json, fetches the migration manifest via npx doccraft@latest llm, and either updates silently (dominant path — no migration entries) or summarises and gates on approval (assisted path — migration…

alexpialetski/doccraft

Skill Claude CodeCodex

Implement tasks from an OpenSpec change. Use when the user wants to start implementing, continue implementation, or work through tasks.

alexpialetski/doccraft

Skill Claude CodeCodex

Archive a completed change in the experimental workflow. Use when the user wants to finalize and archive a change after implementation is complete.

alexpialetski/doccraft

Skill Claude CodeCodex

Enter explore mode - a thinking partner for exploring ideas, investigating problems, and clarifying requirements. Use when the user wants to think through something before or during a change.

alexpialetski/doccraft

Skill Claude CodeCodex

Propose a new change with all artifacts generated in one step. Use when the user wants to quickly describe what they want to build and get a complete proposal with design, specs, and tasks ready for implementation.

alexpialetski/doccraft

Command Cursor

Implement tasks from an OpenSpec change (Experimental).

alexpialetski/doccraft

Command Cursor

Archive a completed change in the experimental workflow.

alexpialetski/doccraft

Command Cursor

Enter explore mode - think through ideas, investigate problems, clarify requirements.

alexpialetski/doccraft

Command Cursor

Propose a new change - create it and generate all artifacts in one step.

alexpialetski/doccraft

Cursor rule Cursor

ADR format for docs/adr — Nygard sections, numbering, status.

alexpialetski/doccraft

Cursor rule Cursor

Working queue in docs/queue.md — keep aligned with backlog and stories.

alexpialetski/doccraft

Cursor rule Cursor

Planning story conventions for docs/stories — follow doccraft-story.

alexpialetski/doccraft

Instructions file

Instructions for alexpialetski/doccraft, covering claude.md, what doccraft is, this repo dogfoods its own skills, setup after cloning and when to re-run install.