plexium-user

Working in a Plexium Repository

This repository uses Plexium to maintain a persistent wiki that compounds knowledge across agent sessions. You are expected to read from and contribute to the wiki as part of your workflow.

The Loop

Every task follows four steps:

1. READ — Before starting work, gather context from the wiki
2. EXECUTE — Do the coding task
3. DOCUMENT — Update wiki pages to reflect what changed
4. VALIDATE — Check that your wiki updates are correct

Step 1: READ

Before writing any code, retrieve relevant context:

# Search the wiki for relevant pages
plexium retrieve "<topic>"

# Or with JSON output for structured parsing
plexium retrieve "<topic>" --format json

Also read directly:

• .wiki/_index.md — full page listing
• .wiki/_log.md — recent changes and decisions
• .wiki/_schema.md — governance rules (read reference/schema-guide.md for details)

If the wiki has an MCP server configured, use pageindex_search instead of shelling out.

Step 2: EXECUTE

Do the coding task. No special requirements here.

Step 3: DOCUMENT

After changing source code, update the wiki:

For module changes — update or create the corresponding page in .wiki/modules/:

---
title: Module Name
ownership: managed
source-files:
  - path/to/changed/file.go
last-updated: 2026-04-06
---

For architectural decisions — create a page in .wiki/decisions/:

---
title: Decision Title
ownership: co-maintained
last-updated: 2026-04-06
---
# Decision Title
## Context
## Decision
## Consequences

Always update _log.md — append a timestamped entry:

- **2026-04-06** — [module-name] Brief description of what changed and why

Trivial change exception: Single-file changes that don't affect architecture only need a _log.md entry.

Step 4: VALIDATE

Before committing:

# Refresh manifest mappings, hashes, and staleness markers
plexium sync

# Check for broken wiki-links, orphan pages, stale mappings
plexium lint --deterministic

# Recompile navigation if you added/removed pages
plexium compile

Ownership Rules

Check page frontmatter before editing:

ownership value	You can...
managed	Freely edit — this page is agent-maintained
human-authored	Do not modify — only humans edit this page
co-maintained	Append to existing sections, do not rewrite

When in doubt, check reference/ownership-model.md.

Quick Reference

Task	Command
Search wiki	plexium retrieve "<query>"
Check health	plexium lint --deterministic
Rebuild nav	plexium compile
Validate setup	plexium doctor
View manifest	Read .plexium/manifest.json

When to Read Reference Docs

• Unsure about wiki-link syntax or cross-references → reference/wiki-links.md
• Need to understand the page taxonomy → reference/taxonomy.md
• Questions about what the schema governs → reference/schema-guide.md
• Need the full ownership model details → reference/ownership-model.md
• Want to understand the retrieval system → reference/retrieval.md