cortex-wiki-author

Solid

Author first-class wiki pages (ADRs, specs, file docs, notes) that live alongside Cortex memory. Use when the user says 'this is an ADR', 'document this decision', 'write an ADR', 'add a spec', 'spec this out', 'document this file', 'add a note about', 'link these pages', 'bookmark this as a spec', or when finalizing a design decision that should persist as a human-readable document.

AI & Automation 68 stars 11 forks Updated today MIT

Install

View on GitHub

Quality Score: 85/100

Stars 20%
61
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Wiki Author — Long-form Documentation Layer ## Keywords adr, spec, decision, design doc, rfc, file doc, notes, wiki, documentation, link pages, bidirectional link, supersedes, implements, depends on ## Overview Cortex's wiki is a Markdown authoring surface for the long-form artifacts that don't fit the thermodynamic memory model: architecture decision records, specs, per-file documentation, and free-form notes. Pages live under `~/.claude/methodology/wiki/` and are **never pruned** — they are first-class authored content, not derived views. Every write also registers a protected pointer memory in PostgreSQL so `recall` surfaces wiki pages alongside regular memories. **Use this skill when:** the user is making a decision that should persist, finalizing a spec, documenting a file's purpose, or asking for two wiki pages to be linked. **Do NOT use for:** ephemeral facts (use `remember`), domain profiles (use `query_methodology`), or regenerating documentation from memory (the wiki is authored, not projected). ## Workflow ### Record an architecture decision ``` cortex:wiki_adr({ "title": "Use pgvector for retrieval", "context": "We need a searchable memory store with hybrid ranking.", "decision": "Adopt PostgreSQL + pgvector + pg_trgm as the single backend.", "consequences": "No SQLite fallback. Operator must provision Postgres 15+.", "status": "accepted", "tags": ["storage", "retrieval"] }) ``` Returns `{ path, number, title, status, ... }`. ADR numbers aut...

Details

Author
cdeust
Repository
cdeust/Cortex
Created
4 months ago
Last Updated
today
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

wiki

Local-first project wiki skill. Ingest raw sources into atris/wiki, query the wiki, lint it, and keep the memory sharp. Triggers on: wiki this, ingest this, query the wiki, lint the wiki.

67 Updated today
atrislabs
AI & Automation Listed

writing-adrs

Use when authoring an Architecture Decision Record (ADR) — a short document that captures one significant, hard-to-reverse technical or architectural decision, its context, and its consequences. Triggered by the sdlc ADR pipeline (the knowledge-engineer agent behind /sdlc:docs seed adr and /sdlc:docs distill) when generating an ADR from a story, and by anyone hand-authoring an ADR under docs/adr/ today. Covers why ADRs are kept short and inverted-pyramid, the required sections (Title, Status, Decision, Context, Alternatives Considered, Consequences), the proposed→accepted→superseded (or →rejected) status lifecycle and the never-edit-only-supersede immutability rule, the NNNN-decision-slug.md filename convention, and the ADR frontmatter fields (status, agents, source-stories) the pipeline reads to route a generated ADR into docs/adr/index.md.

3 Updated today
whimzyLive
AI & Automation Listed

adr-workflow

Scaffold, accept, index, and link Architectural Decision Records (ADRs). Use when the user says "write an ADR", "record this decision", "resolve [deferred item] with an ADR", "supersede ADR-NNNN", or otherwise wants to capture a hard-to-reverse decision in `docs/decisions/`. Also use when a refinement-todo entry needs to be marked RESOLVED with a link back to the ADR. Do NOT use for ad-hoc design discussion that hasn't crystallized into a decision yet — wait until the choice is firm.

4 Updated 2 days ago
ramboz