Rename vault Orion to Polaris: skill dirs, references, README

This commit is contained in:
Avi 2026-09-23 18:07:19 -05:00
commit b35f0c3e3e
16 changed files with 58 additions and 58 deletions

View file

@ -1,15 +1,15 @@
--- ---
name: orion-archive name: polaris-archive
description: "Archive a whole Area (with all its Projects) into a bundle under 5. Archive/, or restore one that's resuming. Moves the Area and Project folders, keeps reusable research in place, downgrades people whose only tie was this Area, writes a tombstone manifest, and repoints every inbound link. People, Threads and Decisions never move. Fully reversible. Triggers on: archive [name], archive area, wind down [name], resume [name], restore [name], unarchive [name]." description: "Archive a whole Area (with all its Projects) into a bundle under 5. Archive/, or restore one that's resuming. Moves the Area and Project folders, keeps reusable research in place, downgrades people whose only tie was this Area, writes a tombstone manifest, and repoints every inbound link. People, Threads and Decisions never move. Fully reversible. Triggers on: archive [name], archive area, wind down [name], resume [name], restore [name], unarchive [name]."
--- ---
# orion-archive — retire or restore a whole Area # polaris-archive — retire or restore a whole Area
**Never delete.** Everything moves to `5. Archive/`; nothing is discarded. The tombstone exists so a later session can find and restore it. **Never delete.** Everything moves to `5. Archive/`; nothing is discarded. The tombstone exists so a later session can find and restore it.
## Archive or close? ## Archive or close?
**Is the Area going away (ended or paused)?** → this skill. **Is the Area staying and one workstream done?** → `orion-close`. Don't close every workstream before archiving an Area — archive the bundle; they travel with it. **Is the Area going away (ended or paused)?** → this skill. **Is the Area staying and one workstream done?** → `polaris-close`. Don't close every workstream before archiving an Area — archive the bundle; they travel with it.
**Archiving is a change, not a repair. Confirm with the owner before moving anything.** **Archiving is a change, not a repair. Confirm with the owner before moving anything.**
@ -22,10 +22,10 @@ description: "Archive a whole Area (with all its Projects) into a bundle under 5
_index.md ← tombstone manifest (required) _index.md ← tombstone manifest (required)
1. Projects/<Area>/... ← every Project under the Area, moved wholesale 1. Projects/<Area>/... ← every Project under the Area, moved wholesale
2. Areas/<Area>/... ← the Area folder, including knowledge/ 2. Areas/<Area>/... ← the Area folder, including knowledge/
<ID>/... ← closed workstreams already here from orion-close — merge, don't collide <ID>/... ← closed workstreams already here from polaris-close — merge, don't collide
``` ```
**If only one Project is being retired and its Area stays live**, it's not an archive — close it (`orion-close`) or pause it. **If only one Project is being retired and its Area stays live**, it's not an archive — close it (`polaris-close`) or pause it.
## What moves, what doesn't ## What moves, what doesn't
@ -89,7 +89,7 @@ tags: [archive, <area-tag>]
Repointed N inbound links; rescan: 0 dead. Repointed N inbound links; rescan: 0 dead.
## If this resumes ## If this resumes
Run `resume <Area>` — orion-archive, restore path. Run `resume <Area>` — polaris-archive, restore path.
``` ```
--- ---

View file

@ -1,9 +1,9 @@
--- ---
name: orion-cascade name: polaris-cascade
description: "Sync an Orion vault's wiki/ navigation layer from the numbered folders. Rewrites wiki/hot.md (current state: outstanding sends, workstreams, the owner's own next moves, people due for follow-up), appends one wiki/log.md entry, rebuilds wiki/index.md when structure changed, and reports how many log entries are waiting to be folded. Run at the end of every session that changed something. Triggers on: cascade, run cascade, sync the wiki, update the wiki." description: "Sync an Polaris vault's wiki/ navigation layer from the numbered folders. Rewrites wiki/hot.md (current state: outstanding sends, workstreams, the owner's own next moves, people due for follow-up), appends one wiki/log.md entry, rebuilds wiki/index.md when structure changed, and reports how many log entries are waiting to be folded. Run at the end of every session that changed something. Triggers on: cascade, run cascade, sync the wiki, update the wiki."
--- ---
# orion-cascade — sync the wiki layer # polaris-cascade — sync the wiki layer
The numbered folders are the source of truth. Cascade reads them and rewrites `wiki/` to match. **One command, no flags.** Always rewrite `hot.md` and append to `log.md`; rebuild `index.md` when you see the structure changed (a hub added, moved, renamed, or its `status`/`area` changed). When in doubt, rebuild it. The numbered folders are the source of truth. Cascade reads them and rewrites `wiki/` to match. **One command, no flags.** Always rewrite `hot.md` and append to `log.md`; rebuild `index.md` when you see the structure changed (a hub added, moved, renamed, or its `status`/`area` changed). When in doubt, rebuild it.
@ -116,7 +116,7 @@ grep -c '^## [0-9]' wiki/log.md # all entry headings
grep -c '\[folded\]' wiki/log.md # fold pointers — not entries grep -c '\[folded\]' wiki/log.md # fold pointers — not entries
``` ```
**Unfolded = headings − pointers.** Threshold **16**. Print the number every run, above or below threshold: `Log: 9 / 16` or `Log: 23 / 16 — fold due`. **Don't run the fold** — that's `orion-fold`, on the owner's word. **Unfolded = headings − pointers.** Threshold **16**. Print the number every run, above or below threshold: `Log: 9 / 16` or `Log: 23 / 16 — fold due`. **Don't run the fold** — that's `polaris-fold`, on the owner's word.
--- ---

View file

@ -1,9 +1,9 @@
--- ---
name: orion-close name: polaris-close
description: "Close a finished workstream in an Orion vault and return its deliverable to the Area that spawned it. Verifies done_when is actually met, splits the output into deliverable (→ 2. Areas/<Area>/knowledge/) and process record (→ 5. Archive/<Area>/<ID>/), updates the Area hub, releases follow-ups tied to the work, and repoints inbound links. Not reversible. Distinct from orion-archive, which retires a whole Area. Triggers on: close workstream, close [ID], this is done, finish workstream, ship it." description: "Close a finished workstream in an Polaris vault and return its deliverable to the Area that spawned it. Verifies done_when is actually met, splits the output into deliverable (→ 2. Areas/<Area>/knowledge/) and process record (→ 5. Archive/<Area>/<ID>/), updates the Area hub, releases follow-ups tied to the work, and repoints inbound links. Not reversible. Distinct from polaris-archive, which retires a whole Area. Triggers on: close workstream, close [ID], this is done, finish workstream, ship it."
--- ---
# orion-close — return a finished workstream to its Area # polaris-close — return a finished workstream to its Area
**An Area spawns a workstream; when the workstream finishes, its deliverable comes home.** The Area is the memory; the workstream is the episode. If finished output archives together with its process, the Area learns nothing and the next workstream starts cold. **An Area spawns a workstream; when the workstream finishes, its deliverable comes home.** The Area is the memory; the workstream is the episode. If finished output archives together with its process, the Area learns nothing and the next workstream starts cold.
@ -15,7 +15,7 @@ description: "Close a finished workstream in an Orion vault and return its deliv
## Close or archive? ## Close or archive?
| | `orion-close` | `orion-archive` | | | `polaris-close` | `polaris-archive` |
|---|---|---| |---|---|---|
| Trigger | One workstream **finished** | A whole Area **ended or paused** | | Trigger | One workstream **finished** | A whole Area **ended or paused** |
| The Area | **Stays, gains knowledge** | Moves into the archive | | The Area | **Stays, gains knowledge** | Moves into the archive |

View file

@ -1,11 +1,11 @@
--- ---
name: orion-daily name: polaris-daily
description: "Close today's daily note in an Orion vault's 0. Inbox/ and write tomorrow's — or write a weekly sweep. The daily note: Focus, Since the last note, one section per workstream that owes something (where it stands · yours · waiting on · a Notes line), Loose, the open-questions manifest, People with what each is tied to, Standing. Carries unanswered questions with a plain-language count and forces a do-it-or-drop-it choice at the third ask. Hard cap 150 lines. The weekly sweep lists every Area, workstream, thread and person with one line each and room to write. Does not ingest — run orion-ingest first, orion-cascade after. Triggers on: daily note, tomorrow's note, close the day, weekly sweep, sweep note." description: "Close today's daily note in an Polaris vault's 0. Inbox/ and write tomorrow's — or write a weekly sweep. The daily note: Focus, Since the last note, one section per workstream that owes something (where it stands · yours · waiting on · a Notes line), Loose, the open-questions manifest, People with what each is tied to, Standing. Carries unanswered questions with a plain-language count and forces a do-it-or-drop-it choice at the third ask. Hard cap 150 lines. The weekly sweep lists every Area, workstream, thread and person with one line each and room to write. Does not ingest — run polaris-ingest first, polaris-cascade after. Triggers on: daily note, tomorrow's note, close the day, weekly sweep, sweep note."
--- ---
# orion-daily — the daily note and the weekly sweep # polaris-daily — the daily note and the weekly sweep
`hot.md` says what's true. **The daily note says what only the owner can answer, and what's quietly drifting.** It is a working surface: the owner writes into it all day, `orion-ingest` files what they write, and this skill builds the next one. `hot.md` says what's true. **The daily note says what only the owner can answer, and what's quietly drifting.** It is a working surface: the owner writes into it all day, `polaris-ingest` files what they write, and this skill builds the next one.
| | Daily note | Weekly sweep | | | Daily note | Weekly sweep |
|---|---|---| |---|---|---|
@ -123,7 +123,7 @@ On request (`weekly sweep`), or offered in `## Standing` when a week has passed
- **Every standing Area**, with **every workstream** under it — open and paused, status named. Fenced Areas named with no contents. - **Every standing Area**, with **every workstream** under it — open and paused, status named. Fenced Areas named with no contents.
- **Every thread.** - **Every thread.**
- **Every person:** relationship tier individually, with what they're tied to · **Released** — relationship-tier people named on a `Released:` line in `wiki/log.md` since the last sweep (written by `orion-close`/`orion-archive`), or whose follow-up points only at closed work · contacts grouped by Area, one line each (`Unplaced` for people tied to nothing live). - **Every person:** relationship tier individually, with what they're tied to · **Released** — relationship-tier people named on a `Released:` line in `wiki/log.md` since the last sweep (written by `polaris-close`/`polaris-archive`), or whose follow-up points only at closed work · contacts grouped by Area, one line each (`Unplaced` for people tied to nothing live).
- **A `> Notes:` line under every workstream and thread**, and one per contact group. - **A `> Notes:` line under every workstream and thread**, and one per contact group.
- **The open-questions manifest.** - **The open-questions manifest.**

View file

@ -1,13 +1,13 @@
--- ---
name: orion-fold name: polaris-fold
description: "Roll up the oldest 2^k entries of an Orion vault's wiki/log.md into a fold page in wiki/folds/, moving the entries verbatim and leaving one pointer line, so the log stays cheap to read. Dry-run by default; writes only on --commit. Run when cascade reports more than 16 unfolded entries. Triggers on: fold the log, run a fold, log rollup, roll up the log." description: "Roll up the oldest 2^k entries of an Polaris vault's wiki/log.md into a fold page in wiki/folds/, moving the entries verbatim and leaving one pointer line, so the log stays cheap to read. Dry-run by default; writes only on --commit. Run when cascade reports more than 16 unfolded entries. Triggers on: fold the log, run a fold, log rollup, roll up the log."
--- ---
# orion-fold — subtractive log rollup # polaris-fold — subtractive log rollup
The log is append-only, so it grows forever. A fold **moves** the oldest entries into a fold page — verbatim, lossless — and leaves one pointer line behind. Entries are never edited or deleted; they live one file over. The log is append-only, so it grows forever. A fold **moves** the oldest entries into a fold page — verbatim, lossless — and leaves one pointer line behind. Entries are never edited or deleted; they live one file over.
**When:** `orion-cascade` prints `Log: N / 16` every run. Over 16 → a fold is due. Default `k=4` (16 entries). **When:** `polaris-cascade` prints `Log: N / 16` every run. Over 16 → a fold is due. Default `k=4` (16 entries).
## Parameters ## Parameters

View file

@ -1,9 +1,9 @@
--- ---
name: orion-ingest name: polaris-ingest
description: "Bring external material into an Orion vault's numbered folders — every capture sitting in 0. Inbox/ by default, or a file, transcript, or document the owner names. Follows any instructions in the source, classifies the rest (asking only when genuinely unclear), records provenance, creates and updates pages directly, cross-links them, marks answered lines in daily notes as filed, and archives processed captures. Distinct from orion-cascade, which syncs wiki/ with what's already in the folders. Triggers on: ingest, process the inbox, ingest this, file this." description: "Bring external material into an Polaris vault's numbered folders — every capture sitting in 0. Inbox/ by default, or a file, transcript, or document the owner names. Follows any instructions in the source, classifies the rest (asking only when genuinely unclear), records provenance, creates and updates pages directly, cross-links them, marks answered lines in daily notes as filed, and archives processed captures. Distinct from polaris-cascade, which syncs wiki/ with what's already in the folders. Triggers on: ingest, process the inbox, ingest this, file this."
--- ---
# orion-ingest — bring material into the vault # polaris-ingest — bring material into the vault
Ingest turns raw capture into filed, cross-linked, attributed vault content. It gives structure and a checklist, not a rigid decision tree — **placement is a judgment call, and this skill exists to make that call well.** Ingest turns raw capture into filed, cross-linked, attributed vault content. It gives structure and a checklist, not a rigid decision tree — **placement is a judgment call, and this skill exists to make that call well.**
@ -32,7 +32,7 @@ If the source says what to do ("file this under X", "this is for reference only"
| Reference that needs one Area's frame | `2. Areas/<Area>/knowledge/` | | Reference that needs one Area's frame | `2. Areas/<Area>/knowledge/` |
| Reference that holds anywhere | `3. Resources/Research/` — topic tags only | | Reference that holds anywhere | `3. Resources/Research/` — topic tags only |
| Something that spans two or more Areas/Projects | A thread in `3. Resources/Threads/`, or an update to an existing one | | Something that spans two or more Areas/Projects | A thread in `3. Resources/Threads/`, or an update to an existing one |
| Finite new work | Suggest `new project:` — creation goes through `orion-instantiate` | | Finite new work | Suggest `new project:` — creation goes through `polaris-instantiate` |
| A binary (PDF, deck, image, spreadsheet) | **Not into the vault.** It stays in the file system; the vault gets a reference note of what it says, attributed, with the file path | | A binary (PDF, deck, image, spreadsheet) | **Not into the vault.** It stays in the file system; the vault gets a reference note of what it says, attributed, with the file path |
**When it is genuinely unclear which row applies, ask.** That is the one checkpoint that stops execution. Everything else runs directly — no dry run, no confirmation gate. **When it is genuinely unclear which row applies, ask.** That is the one checkpoint that stops execution. Everything else runs directly — no dry run, no confirmation gate.
@ -58,7 +58,7 @@ If a name in the source matches the *Never use* column of `AGENTS.md`'s vocabula
Move each processed capture to `0. Inbox/processed/YYYY-MM/` (year first — e.g. `processed/2026-01/`). **Never delete** — the capture is the record of what came in and when. Move each processed capture to `0. Inbox/processed/YYYY-MM/` (year first — e.g. `processed/2026-01/`). **Never delete** — the capture is the record of what came in and when.
⚠ **Never archive a file tagged `daily-note` or `weekly-sweep`.** Those are working surfaces the owner writes into all day. File their contents and leave them in place — only `orion-daily` retires them, once a successor exists. ⚠ **Never archive a file tagged `daily-note` or `weekly-sweep`.** Those are working surfaces the owner writes into all day. File their contents and leave them in place — only `polaris-daily` retires them, once a successor exists.
### Marking what's been filed ### Marking what's been filed
@ -68,7 +68,7 @@ In daily notes and sweeps, for every `>` line with text after it — an answered
- An empty `> Notes:` or blank question is not a failure — ignore it. - An empty `> Notes:` or blank question is not a failure — ignore it.
- In a sweep, a ticked box with no note means "reviewed, nothing changed." Nothing to file. - In a sweep, a ticked box with no note means "reviewed, nothing changed." Nothing to file.
`orion-daily` reads these markers to decide what carries forward, and refuses to retire a note with unfiled text. `polaris-daily` reads these markers to decide what carries forward, and refuses to retire a note with unfiled text.
## 7. Output ## 7. Output

View file

@ -1,9 +1,9 @@
--- ---
name: orion-instantiate name: polaris-instantiate
description: "Create a Project (workstream) or Area in an Orion vault against its frontmatter contract. Runs the done-when test first, assigns the workstream ID from the Area's counter, seeds the Area's knowledge/ folder, and registers the new hub so it is never an orphan. Also converts a Project that turns out to be an Area. Triggers on: new project, new area, new workstream, create project, create area, instantiate, this should be an area." description: "Create a Project (workstream) or Area in an Polaris vault against its frontmatter contract. Runs the done-when test first, assigns the workstream ID from the Area's counter, seeds the Area's knowledge/ folder, and registers the new hub so it is never an orphan. Also converts a Project that turns out to be an Area. Triggers on: new project, new area, new workstream, create project, create area, instantiate, this should be an area."
--- ---
# orion-instantiate — create a Project or Area # polaris-instantiate — create a Project or Area
Creation is where most structural defects start: a hub with no done-when never finishes, a hub with no Area can never be measured against anything, and a hub nobody links to is an orphan from day one. This skill makes creation follow the contract in `6. Templates/_contracts.md` instead of copying a template and hoping. Creation is where most structural defects start: a hub with no done-when never finishes, a hub with no Area can never be measured against anything, and a hub nobody links to is an orphan from day one. This skill makes creation follow the contract in `6. Templates/_contracts.md` instead of copying a template and hoping.
@ -64,7 +64,7 @@ A Project that fails the done-when test isn't finished — it was misfiled. **As
2. **Route everything in a table in the hub:** each task or sub-effort → done (history) · ongoing (Area open item) · has a real done-when (its own new Project with an ID) · dead (closed, reason stated). 2. **Route everything in a table in the hub:** each task or sub-effort → done (history) · ongoing (Area open item) · has a real done-when (its own new Project with an ID) · dead (closed, reason stated).
3. Move the folder to `2. Areas/<Name>/`, rename the hub `<Name>_hub.md`, set `type: area`, `status: standing`. 3. Move the folder to `2. Areas/<Name>/`, rename the hub `<Name>_hub.md`, set `type: area`, `status: standing`.
4. ⚠ **Give it `id_prefix:` and `workstream_counter: 0` now.** Conversion is the one path into Area-hood that skips the creation contract; an Area without a counter can never spawn a workstream, and nothing reports it. 4. ⚠ **Give it `id_prefix:` and `workstream_counter: 0` now.** Conversion is the one path into Area-hood that skips the creation contract; an Area without a counter can never spawn a workstream, and nothing reports it.
5. Seed `knowledge/_index.md`. Repoint inbound links (see `orion-close` step 6 for method). Log it. Cascade. 5. Seed `knowledge/_index.md`. Repoint inbound links (see `polaris-close` step 6 for method). Log it. Cascade.
--- ---

View file

@ -1,9 +1,9 @@
--- ---
name: orion-lint name: polaris-lint
description: "Health-check an Orion vault: dead links, orphans, frontmatter and workstream-contract gaps, people-tier defects, unsourced reference material, vocabulary violations, misplaced files, stale holds, and an overdue log fold. Flags only — never auto-fixes. Writes exactly one wiki/meta/lint-report-YYYY-MM-DD.md stamped with the git commit it describes; the previous report is archived. Triggers on: lint, health check, audit the vault, check the vault, find orphans, find dead links." description: "Health-check an Polaris vault: dead links, orphans, frontmatter and workstream-contract gaps, people-tier defects, unsourced reference material, vocabulary violations, misplaced files, stale holds, and an overdue log fold. Flags only — never auto-fixes. Writes exactly one wiki/meta/lint-report-YYYY-MM-DD.md stamped with the git commit it describes; the previous report is archived. Triggers on: lint, health check, audit the vault, check the vault, find orphans, find dead links."
--- ---
# orion-lint — vault health check # polaris-lint — vault health check
**Flags only.** Lint reports; the owner or the next session decides. (Repairs lint surfaces may then be made under the *Repair* rule in `AGENTS.md`.) **Flags only.** Lint reports; the owner or the next session decides. (Repairs lint surfaces may then be made under the *Repair* rule in `AGENTS.md`.)

View file

@ -51,9 +51,9 @@ Body: `## What this is` · `## Tasks` (checkboxes, `(owned by: name)` when not t
- **`done_when:` is required.** If you can't write it, it isn't a Project. If it needs the words "ongoing", "maintain" or "as needed", it's an Area. - **`done_when:` is required.** If you can't write it, it isn't a Project. If it needs the words "ongoing", "maintain" or "as needed", it's an Area.
- **`next:` — one move per entry.** Two moves go in a YAML list, never packed into one string. Grammar and verbs → `AGENTS.md`, *The `next:` field*. - **`next:` — one move per entry.** Two moves go in a YAML list, never packed into one string. Grammar and verbs → `AGENTS.md`, *The `next:` field*.
- **`area: none` is legal but must be written.** Such a project has no knowledge base to receive its deliverable; `orion-close` archives it whole. - **`area: none` is legal but must be written.** Such a project has no knowledge base to receive its deliverable; `polaris-close` archives it whole.
**A workstream *is* a Project.** It opens when an Area needs finite work done, and closes via `orion-close`, which returns its deliverable to the Area: **A workstream *is* a Project.** It opens when an Area needs finite work done, and closes via `polaris-close`, which returns its deliverable to the Area:
``` ```
Area ──spawns──▶ Project (id, done_when) Area ──spawns──▶ Project (id, done_when)

View file

@ -1,6 +1,6 @@
# Orion — Operating Manual # Polaris — Operating Manual
You are operating an **Orion vault**: a plain-markdown knowledge base, organised by PARA, maintained by an AI agent on behalf of one human — **the owner**. This file is the rulebook. It holds only the rules that change how you behave *by default*. Everything else is one read away: You are operating an **Polaris vault**: a plain-markdown knowledge base, organised by PARA, maintained by an AI agent on behalf of one human — **the owner**. This file is the rulebook. It holds only the rules that change how you behave *by default*. Everything else is one read away:
| Need | Read | | Need | Read |
|---|---| |---|---|
@ -19,14 +19,14 @@ Every command below maps to a skill file. **If your harness loads skills nativel
| Say this | Skill | | Say this | Skill |
|---|---| |---|---|
| `new project:` · `new area:` · `new workstream: [area] / [name]` | `orion-instantiate` | | `new project:` · `new area:` · `new workstream: [area] / [name]` | `polaris-instantiate` |
| `ingest` · `process the inbox` | `orion-ingest` | | `ingest` · `process the inbox` | `polaris-ingest` |
| `cascade` | `orion-cascade` | | `cascade` | `polaris-cascade` |
| `daily note` · `weekly sweep` | `orion-daily` | | `daily note` · `weekly sweep` | `polaris-daily` |
| `close workstream: [id]` | `orion-close` | | `close workstream: [id]` | `polaris-close` |
| `archive: [name]` · `resume [name]` | `orion-archive` | | `archive: [name]` · `resume [name]` | `polaris-archive` |
| `lint` | `orion-lint` | | `lint` | `polaris-lint` |
| `fold the log` | `orion-fold` | | `fold the log` | `polaris-fold` |
**Creates one page** — no skill; copy the matching skeleton in `6. Templates/` and satisfy its contract in `_contracts.md`: **Creates one page** — no skill; copy the matching skeleton in `6. Templates/` and satisfy its contract in `_contracts.md`:
@ -76,7 +76,7 @@ Every command below maps to a skill file. **If your harness loads skills nativel
- `wiki/hot.md` — **current state.** The one file to read at the start of every session. Rewritten by each cascade. Hard cap 80 lines. - `wiki/hot.md` — **current state.** The one file to read at the start of every session. Rewritten by each cascade. Hard cap 80 lines.
- `wiki/index.md` — the inventory: every hub, person, thread and decision, one line each. Rebuilt by cascade when structure changes. - `wiki/index.md` — the inventory: every hub, person, thread and decision, one line each. Rebuilt by cascade when structure changes.
- `wiki/log.md` — append-only ledger of every operation. Newest first. - `wiki/log.md` — append-only ledger of every operation. Newest first.
- `wiki/folds/` — old log entries rolled up by `orion-fold`, kept verbatim. - `wiki/folds/` — old log entries rolled up by `polaris-fold`, kept verbatim.
- `wiki/meta/` — `tags.md`, `holds.md`, `open-questions.md`, and the one current lint report. - `wiki/meta/` — `tags.md`, `holds.md`, `open-questions.md`, and the one current lint report.
**Rule:** all knowledge lives in the numbered folders. `wiki/` reflects their state; it never holds content. **`wiki/` must stay smaller than the numbered folders** — if navigation outgrows the territory, it has become content. **Rule:** all knowledge lives in the numbered folders. `wiki/` reflects their state; it never holds content. **`wiki/` must stay smaller than the numbered folders** — if navigation outgrows the territory, it has become content.
@ -142,7 +142,7 @@ Paths listed here are **never read, edited, scanned, or summarised** by any skil
|---|---| |---|---|
| `open` | **The working status.** Real, identified work. No clock, no cap. Needs `done_when:`. `next:` optional. | | `open` | **The working status.** Real, identified work. No clock, no cap. Needs `done_when:`. `next:` optional. |
| `paused` | Deliberately not now. Needs `paused_because:`. **Invisible to every freshness check** — that is the point. | | `paused` | Deliberately not now. Needs `paused_because:`. **Invisible to every freshness check** — that is the point. |
| `closed` | Done. Deliverable migrated to its Area's `knowledge/` via `orion-close`. | | `closed` | Done. Deliverable migrated to its Area's `knowledge/` via `polaris-close`. |
| `archived` | Lives in `5. Archive/`. | | `archived` | Lives in `5. Archive/`. |
**Areas** are `standing` or `archived`. A standing Area carries no attention status — never compute freshness or drift on one. **Areas** are `standing` or `archived`. A standing Area carries no attention status — never compute freshness or drift on one.
@ -217,7 +217,7 @@ When something new arrives, in this order:
## Vocabulary enforcement ## Vocabulary enforcement
Canonical spellings of names and terms. `orion-lint` parses this table — keep the two-column shape. Canonical spellings of names and terms. `polaris-lint` parses this table — keep the two-column shape.
| Always use | Never use | | Always use | Never use |
|---|---| |---|---|
@ -245,4 +245,4 @@ A `[build]` entry **must** carry a `Shipped:` line naming what exists now that d
## Delegation (optional) ## Delegation (optional)
`orion-cascade`, `orion-lint` and `orion-fold` are mechanical — glob, parse, compare. If your harness supports subagents, they can run on a cheaper model. **The main session still verifies any count or name before it reaches `hot.md` or `log.md`**; a subagent's claim that it verified something is not verification. `orion-ingest` and `orion-daily` require judgment and stay in the main session. `polaris-cascade`, `polaris-lint` and `polaris-fold` are mechanical — glob, parse, compare. If your harness supports subagents, they can run on a cheaper model. **The main session still verifies any count or name before it reaches `hot.md` or `log.md`**; a subagent's claim that it verified something is not verification. `polaris-ingest` and `polaris-daily` require judgment and stay in the main session.

View file

@ -1,4 +1,4 @@
# Orion # Polaris
The operating manual for this vault is `AGENTS.md`, shared by every agent that drives it. The operating manual for this vault is `AGENTS.md`, shared by every agent that drives it.

View file

@ -1,4 +1,4 @@
# Orion # Polaris
*A second brain management system for AI harnesses.* *A second brain management system for AI harnesses.*

View file

@ -6,7 +6,7 @@ updated: YYYY-MM-DD
# Hot # Hot
*Rewritten by `orion-cascade`. Never append. Hard cap 80 lines.* *Rewritten by `polaris-cascade`. Never append. Hard cap 80 lines.*
## Outstanding sends ## Outstanding sends

View file

@ -6,7 +6,7 @@ updated: YYYY-MM-DD
# Index # Index
*Rebuilt by `orion-cascade` when structure changes. One line per page. Navigation only — never prose.* *Rebuilt by `polaris-cascade` when structure changes. One line per page. Navigation only — never prose.*
## Areas ## Areas

View file

@ -7,7 +7,7 @@ tags:
# Open questions # Open questions
**The register of decisions nobody has made yet.** Numbered, never renumbered — a closed question keeps its number. Items arrive here from `orion-lint` (a finding carried two cycles) and `orion-cascade` (a warning carried two runs). Each is written as a forced binary: **The register of decisions nobody has made yet.** Numbered, never renumbered — a closed question keeps its number. Items arrive here from `polaris-lint` (a finding carried two cycles) and `polaris-cascade` (a warning carried two runs). Each is written as a forced binary:
`N. **Question** — Option A / Option B. Raised YYYY-MM-DD.` `N. **Question** — Option A / Option B. Raised YYYY-MM-DD.`

View file

@ -9,7 +9,7 @@ tags:
## Area tags ## Area tags
One tag per Area, carried by its hub and everything under it — its Projects and its `knowledge/` notes. Registered here by `orion-instantiate`. One tag per Area, carried by its hub and everything under it — its Projects and its `knowledge/` notes. Registered here by `polaris-instantiate`.
| Tag | Area | | Tag | Area |
|---|---| |---|---|