# Docs Order

> Reference for documentation workflow execution order and dependencies. Use when this capability is needed.

- Skill: `tomevault-io/docs-order` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/docs-order`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/docs-order/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/docs-order

---


# Documentation Workflow Order

This skill provides the execution order for documentation workflows. Reference this when completing any `/docs.*` workflow to know what to run next.

## Execution Order

| Step | Workflow | What It Does |
|------|----------|--------------|
| **1** | `/docs.rust` | Detects & fixes missing Rust docs (`///`, `//!`, `// ===`, CLI `long_about`/`after_help`) |
| **2** | `/docs.frontend` | Detects & fixes missing TSX docs (`@module`, Props JSDoc, state/effect comments, sections) |
| **3** | `/docs.skills` | Generates SKILL.md and command docs from CLI attributes |
| **4** | `/docs.update` | Updates crates/docs/*.md and crate READMEs |
| **5** | `/docs.readme` | Updates main README, CONTRIBUTING, npm/README |

## Dependency Graph

```
/docs.rust ──────┬──► /docs.skills ──► /docs.update ──► /docs.readme
                 │
/docs.frontend ──┘
```

## Key Dependencies

- `/docs.skills` must run after `/docs.rust` (reads CLI `long_about`/`after_help`)
- `/docs.update` must run after `/docs.skills` (references CLI command docs)
- `/docs.readme` must run last (reads from `crates/docs/*.md`)
- `/docs.rust` and `/docs.frontend` can run in parallel

## When to Run Each

| If you changed... | Run these workflows... |
|-------------------|------------------------|
| Rust code logic | `/docs.rust` → `/docs.update` |
| CLI commands | `/docs.rust` → `/docs.skills` → `/docs.update` → `/docs.readme` |
| Frontend components | `/docs.frontend` |
| API endpoints | `/docs.frontend` → `/docs.update` |
| Vision/messaging | `/docs.readme` only |
| Everything | All in order |

## Full Refresh

```bash
# Complete documentation refresh (in order):
/docs.rust
/docs.frontend  
/docs.skills
/docs.update
/docs.readme
```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/fnsk4r17s) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->