wiki — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited wiki (Agent Skill) and scored it 92/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 2 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 2 flagged
The text {match} tells the agent to skip the normal "ask the user first" gate. Used adversarially it removes the human-in-the-loop check before destructive or sensitive actions, turning a normally-gated agent into a fire-and-forget executor.
The text {match} tells the agent to skip the normal "ask the user first" gate. Used adversarially it removes the human-in-the-loop check before destructive or sensitive actions, turning a normally-gated agent into a fire-and-forget executor.
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
Workspace knowledge base and self-improvement loop. The coordinator queries wiki before broad exploration; ingest learnings after every task.
The wiki exists to eliminate unnecessary codebase exploration: with the right knowledge the agent goes straight to relevant code; if exploration is still needed, the wiki narrows it — focused and directed, not open-ended.
The main agent reads wiki/index.md BEFORE team composition or workspace exploration — this is the coordinator's first action after receiving a request. Specialists use handoff context unless wiki lookup is explicitly needed for their scope.
Language: All wiki content defaults to English. Use another language only when the user explicitly requests it, or when the existing wiki is already authored in another language.
Prose: No hard-wrapping — paragraphs flow as single lines; the renderer wraps. Write what matters, skip the rest; no preambles, no filler.
Wiki files are loaded into agent context. Every line costs tokens.
.md files only (page or subfolder's index.md, never the folder itself); no instructions, rules, or detailed contentKeep it dense. Patterns, conventions, examples — all welcome if compact and actionable. Cut ruthlessly: if a sentence doesn't help the agent decide or act, delete it.
Never add raw data to the wiki. Logs, stack traces, command outputs, API responses, and dumps are ephemeral artifacts, not knowledge. Store distilled insights: what was learned, what pattern was identified, what decision was made. If a log reveals an error condition worth remembering, write "X error happens when Y" — not the full log.
Date-bound artifacts go in `wiki/records/`. Material from a specific event worth keeping — e.g., incidents, research, audits, meetings, reviews. Use a YYYYMMDD- filename prefix (e.g., wiki/records/incidents/20260110-pg-outage.md).
Setup — create wiki/ when new knowledge must be persisted and the directory doesn't exist yet. For broad wiki setup/creation, use orchestrate roles for Workspace Research / Architecture Analysis and Technical Writing / Documentation; add Review / Consistency when persistent docs are created.
Query — coordinator reads wiki/index.md first to route by descriptions and keywords. Choose the most relevant direct page or folder index, then load only relevant linked pages.
Ingest — end of every task, the coordinator evaluates automatically if anything was learned.
The coordinator runs this checklist at the end of EVERY task. Do NOT skip.
wiki/decisions/<NNNN-decision-name>.mdwiki/conventions/<pattern-name>.mdwiki/domain/<rule-name>.md (descriptive facts; prescriptive contracts go in specs/<domain>/spec.md — specs are the prescriptive source of truth; on spec archive, descriptive counterparts are ingested here — see spec-builder)wiki/architecture.mdAny YES → ingest. All NO → skip (but each item must have been evaluated).
Wiki vs skill. Wiki = declarative knowledge (what is true / decided / how the system is). Skill = recurring procedural workflow (multi-step, triggered often, improves with explicit instruction). Only when the content is clearly procedural AND clearly recurring — flag to the user: "this reads like a skill — create one with skill-builder, or keep in wiki?" Never create the skill; the user decides. One-off or rare → wiki, stay silent. Decisions, architecture facts, domain rules, one-off conventions → always wiki, no signal. When in doubt → wiki, stay silent.
If the coordinator is prohibited from editing wiki files directly, delegate the wiki edit as a handoff and review the result before final response.
Do NOT ask "should I update the wiki?" — evaluate automatically.
wiki/
├── index.md # Required routing map — compact descriptions + keywords
├── architecture.md # System structure overview (single file)
├── conventions/ # One file per convention
│ ├── index.md # Optional folder index for larger/topic-rich wikis
│ └── <pattern-name>.md
├── domain/ # One file per business rule — descriptive, post-hoc distilled facts (prescriptive behavior contracts go in specs/<domain>/spec.md; specs are the prescriptive source of truth, and on spec archive their descriptive counterparts are ingested here — see spec-builder)
│ ├── index.md
│ └── <rule-name>.md
├── decisions/ # One file per ADR
│ └── <NNNN-decision-name>.md
├── records/ # Date-bound artifacts
└── ...This is a starting point. Create additional folders/subfolders as needed — for projects, features, work-in-progress, or any grouping that improves organization. One topic per file, one concept per folder; keep it navigable.
Every wiki page must be reachable from wiki/index.md, directly or through linked folder-level index.md files. Small wikis may link directly to all pages from root; larger or topic-rich wikis should use folder indexes so the root stays a compact routing map with enough keywords to choose the right path.
As a heuristic, split when wiki/index.md exceeds ~50 lines OR a single topic group exceeds ~10 entries: move that group into a folder-level index.md and link the folder index from root instead of the individual pages. Guidance, not law — apply judgment, but they're easy to check by counting.
wiki/index.md first.When the wiki changes, maintain it deliberately.
wiki/index.md and related pages.When the wiki changes, check for:
.md files, not folderswiki/index.md directly or through folder indexesDo not leave the wiki internally inconsistent after editing it.
| Excuse | Reality |
|---|---|
| "I didn't learn anything new" | Run the checklist. |
| "This is too minor to document" | Minor insights compound. |
| "I'll update it later" | You won't. |
| "Too specific to track" | Track anyway. |
| "The log proves it happened" | Distill the insight, not the raw data. |
wiki/index.md are invisible. Keep root and folder indexes updated when pages are added, moved, or removed — but keep them lean: descriptions and keywords only.~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.