# Project Docs

> Project documentation structure — standard proj-[name]/ layout with ADRs, stories, and operations guides. Use when: initializing docs for a new project, recording architecture decisions, or maintaining project knowledge bases.

- **Type:** Skill
- **Install:** `agentstack add skill-cablate-ai-toolkit-project-docs`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [cablate](https://agentstack.voostack.com/s/cablate)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [cablate](https://github.com/cablate)
- **Source:** https://github.com/cablate/ai-toolkit/tree/master/skills/project-docs

## Install

```sh
agentstack add skill-cablate-ai-toolkit-project-docs
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Project Documentation

## Core Principles

- **Docs are for future you** — Good docs let you resume context in 5 minutes after 3 months away
- **Record decisions, not just results** — "We use X" is not enough. Record "why X, not Y"

## Project Docs Structure

Each project gets a `proj-[name]/` directory:

```
proj-[name]/
├── SKILL.md                    # Project entry point (concise summary)
└── references/
    ├── _index.md               # Navigation guide
    ├── product/
    │   ├── vision.md           # What problem this project solves
    │   └── principles.md       # Core development principles
    ├── system/
    │   └── overview.md         # System architecture overview
    ├── decisions/
    │   ├── _index.md           # Decision index
    │   ├── adr/                # Architecture Decision Records
    │   └── stories/            # Feature stories
    └── operations/
        ├── quick-nav.md        # Quick navigation
        └── troubleshooting.md  # Common issues & solutions
```

## Initializing a New Project

1. Create the directory structure above
2. Fill `product/vision.md` — What problem does this project solve?
3. Define `product/principles.md` — What are the core development principles?
4. Document `system/overview.md` — What does the system look like now?
5. Backfill `decisions/adr/` — Record important technical choices already made

> See [doc-standards.md](references/doc-standards.md) for ADR format, story format, and naming conventions.

## References

| File | Content |
|------|---------|
| [doc-standards.md](references/doc-standards.md) | Document formats and templates |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [cablate](https://github.com/cablate)
- **Source:** [cablate/ai-toolkit](https://github.com/cablate/ai-toolkit)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-cablate-ai-toolkit-project-docs
- Seller: https://agentstack.voostack.com/s/cablate
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
