> ## Documentation Index
> Fetch the complete documentation index at: https://docs.10et.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge Docs

> Lifecycle management with tenet organize

Knowledge docs (VISION.md, THESIS.md, etc.) are living documents that should evolve with your project. `tenet organize` audits them for staleness.

## The Problem

Knowledge docs drift. You write VISION.md on day 1, then 30 days of journals accumulate with decisions, pivots, and discoveries that the doc doesn't reflect.

## The Solution

```bash theme={null}
tenet organize
```

Scans docs against journal evidence, computes drift scores, generates `PENDING.md` with proposed updates and open questions.

See [tenet organize](/cli/organize) for the full command reference.

## Recommended Structure

```
knowledge/
├── VISION.md            # What we're building (update quarterly)
├── THESIS.md            # Why we win (update with competitive changes)
├── NARRATIVE.md         # How we tell the story (update with product changes)
├── PHILOSOPHY.md        # Core principles (rarely changes)
├── BRAND_DECISIONS.md   # Visual identity, naming (update with rebrand)
└── archive/             # Old docs organized by era
    ├── specs/
    ├── research/
    └── strategy/
```

## Lifecycle

<Steps>
  <Step title="Created">Manual or via `tenet init`</Step>
  <Step title="Stale detected">`tenet organize` flags docs with no journal references</Step>
  <Step title="PENDING.md generated">Proposed updates + open questions for human review</Step>
  <Step title="Human reviews">Answers questions, approves changes</Step>
  <Step title="Applied">`tenet organize --apply` commits changes</Step>
  <Step title="Archive">If no activity for 60 days → `knowledge/archive/`</Step>
</Steps>