@codyswann/lisa 4.74.9 → 4.75.0

package/plugins/lisa-wiki-devin/skills/lisa-wiki-setup/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: lisa-wiki-setup
+description: Scaffold, repair, verify, or upgrade a project's LLM Wiki from its config. Use when setting up the wiki in a new repo, fixing a broken/incomplete structure, or upgrading to a newer kernel version. Asks the wiki's purpose and README mode, renders the contract snapshot, scaffolds the canonical folders, and seeds the staff roster. Idempotent and non-destructive.
+---
+
+# lisa-wiki-setup
+
+Bring a repo's `wiki/` into conformance with the canonical structure from
+`wiki/lisa-wiki.config.json`. Safe to re-run: it creates what is missing and repairs drift, but
+never overwrites human-authored content.
+
+## When to use
+- First-time setup of the wiki in a repo.
+- Repairing a wiki that fails `/doctor` structural checks.
+- Upgrading after a new `lisa-wiki` release (`--upgrade`): re-render the contract snapshot and run a
+  compatibility report before writing.
+- `--with-ci`: also install the optional GitHub Action validator (`ci/lisa-wiki-validate.yml`).
+
+## Workflow
+1. **Config.** Read `wiki/lisa-wiki.config.json`, or create it interactively. Ask for: `org`,
+   `displayName`, **`purpose`** (one paragraph — what this wiki is for), `mode`
+   (`embedded|wrapper|standalone|subdir`), `categories`, source layout, connectors, sensitivity,
+   `sourceRetention`, and the **README mode** (`rich` default | `stub` | `preserve` — always ask;
+   never select `stub` implicitly). If `staff` is absent, seed the **standard roster** (below) as the
+   default — every wiki gets the standard operating team unless the user opts out or edits it. Union
+   each role's owned categories into `config.categories`. Validate with `scripts/validate-config.mjs`.
+2. **Structure.** Scaffold the canonical tree per `schema/wiki-structure.schema.json`:
+   `wiki/{index.md, log.md, start-here.md, schema/, sources/, state/, staff/, <category dirs>}`.
+   Create only what is missing.
+3. **Contract.** Render `wiki/schema/llm-wiki-contract.md` from the plugin templates + config via
+   `scripts/render-contract.mjs`, stamping the `kernelVersion`. This snapshot keeps the wiki
+   self-describing without the plugin installed.
+4. **Gitignore.** Merge the lisa-wiki gitignore block into the project's `.gitignore` via
+   `scripts/ensure-gitignore.mjs`. The block (delimited by `# BEGIN: AI GUARDRAILS WIKI` /
+   `# END: AI GUARDRAILS WIKI`) covers transient per-session worktrees and Lisa backup snapshots
+   (`.claude/worktrees/`, `.codex/worktrees/`, `.lisabak/`). Idempotent: re-running produces no
+   diff once the block is present. The block coexists with the base lisa plugin's
+   `# BEGIN: AI GUARDRAILS` block — both can be installed without overwriting each other because
+   the copy-contents strategy keys on the marker suffix. Wiki-wrapper repos (mode `wrapper` /
+   `standalone`) typically don't enable the base lisa plugin, so this step is the only path by
+   which they get the worktree-ignore patterns.
+5. **Pointers.** Ensure `AGENTS.md` / `CLAUDE.md` point at the contract + plugin (thin pointers only).
+6. **Staff.** For each `config.staff[]` entry (the standard roster by default), generate the role's
+   `wiki/staff/<role>.md` page and its dual-runtime subagents by delegating to `lisa-wiki-add-role`
+   (running the subagents is out of scope).
+7. **README.** Apply the chosen README mode (ingest the old README first; `rich` keeps install/usage +
+   adds the onboarding line; `stub` is the minimal pointer; `preserve` leaves it).
+8. **Verify.** Run `lisa-wiki-doctor` and report the verdict + any blocking items.
+
+## Standard roster
+The default operating team seeded into `config.staff[]` for every new wiki (Chief of Staff plus six
+domain agents). Each role becomes a `wiki/staff/<id>.md` page and a dual-runtime subagent; the human
+owner talks to Chief, who routes to the others. Owned categories are unioned into `config.categories`.
+
+| id | role | owns (categories) | sensitivity |
+|---|---|---|---|
+| `chief` | Chief of Staff | `projects`, `decisions`, `playbooks`, `open-questions` | confidential |
+| `sally` | Sales | `sales` | internal |
+| `mark` | Marketing | `marketing` | internal |
+| `felix` | Finance | `finance` | confidential |
+| `casey` | Customer Success | `customers` | internal |
+| `parker` | People | `people` | confidential |
+| `lex` | Legal & Compliance | `legal` | confidential |
+
+Projects may add, remove, or rename roles afterward; the standard roster is the starting point, not a
+constraint.
+
+## Rules
+- Idempotent; re-running produces no spurious changes.
+- Never overwrite human content; only create/repair structure and the rendered snapshot. The README is
+  rewritten only after its old content has been ingested, and only per the chosen `readme.mode`.
+- Project-scoped only; never stage secrets/OAuth artifacts; honor `mode` safety (wrapper/standalone).
+
+## Related
+`lisa-wiki-add-role`, `lisa-wiki-doctor`, `lisa-wiki-migrate`, `lisa-wiki-usage`.

package/plugins/lisa-wiki-devin/skills/lisa-wiki-setup-automations/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: lisa-wiki-setup-automations
+description: "Set up the recurring LLM Wiki ingest automation on the local workstation using the CURRENT runtime's native scheduler — Codex automations (the native automations / automation_update mechanism) or, on Claude, /schedule. This skill is a declarative specification: it states WHICH automation to create, how often, and with which command; it does not template schedule files or run scheduling code itself — the runtime's native automation mechanism does the creating. Creates one automation: wiki-ingest, a full /lisa-wiki:ingest cycle, once a day by default (override with cadence). Named and scoped lisa-wiki-auto-<project>-* so it never collides with or clobbers the base /setup-automations set. The wiki counterpart of /lisa:setup-automations — it lives here because the wiki plugin is standalone and installable without the base plugin. Tear down with /lisa-wiki:tear-down-automations."
+allowed-tools: ["Skill", "Bash", "Read"]
+---
+
+# Set up LLM Wiki automations: $ARGUMENTS
+
+This skill is a **specification, not a script.** It tells the current runtime which recurring wiki
+automation to create, on what cadence, and with which command — and the runtime creates it with its
+**native** scheduling mechanism. Do **not** hand-template schedule files or write shell to create
+them; invoke the runtime's automation tool with the spec below.
+
+It is the wiki counterpart of the base `/lisa:setup-automations`. It is a **separate** skill because
+the wiki plugin (`lisa-wiki`) is standalone — it can be installed without the base Lisa plugin, in
+which case `/lisa:setup-automations` is not present to schedule ingest. The two skills are
+independent and use disjoint name prefixes, so running both is safe.
+
+## Runtime scheduler (branch on the current runtime)
+
+- **Codex** → create a Codex **automation** via the native automations mechanism (prefer the
+  `automation_update` tool over hand-writing `~/.codex/automations/<id>/automation.toml`; the TOML is
+  only its backing store). Set the execution environment to **local** so it runs on this
+  workstation. Scope it to a durable project automation checkout, not a transient task worktree: use
+  `${CODEX_HOME:-~/.codex}/worktrees/<project>-automation-main` when available, create or refresh
+  that checkout from the project's `origin` remote if needed, and verify `git -C <cwd> rev-parse
+  --is-inside-work-tree --is-bare-repository` reports `true` then `false` before saving the
+  automation. Do not point recurring automations at hashed scratch worktrees or a checkout whose Git
+  metadata is broken.
+- **Claude** → use **`/schedule`** to create a local recurring routine.
+- **Other runtimes** → use the runtime's native recurring-task mechanism. If the runtime has none,
+  state that scheduling is unavailable and stop.
+
+## Parameters
+
+- `cadence` (default **daily**) — how often the full ingest runs. Accepts `daily`, `weekly`, or an
+  `every-<n>-hours` form. Map to a Codex `rrule`: daily → `FREQ=DAILY;INTERVAL=1`; weekly →
+  `FREQ=WEEKLY;INTERVAL=1`; every N hours → `FREQ=HOURLY;INTERVAL=<n>`. On Claude, pass the
+  equivalent `/schedule` cadence. Default is **daily** (`FREQ=DAILY;INTERVAL=1`).
+
+## The automation to create
+
+The automation runs **one cycle** of the full wiki ingest and respects that command's own confirmation
+and commit/PR policy (never ask before running; run a full ingest across every enabled
+non-external-write source; commit/PR per the ingest skill's bookends; report the cycle summary).
+Before running the ingest, the automation must attempt to sync its checkout: fetch the default remote
+branch and rebase the current automation branch onto it (for the common GitHub case, `origin/main`).
+If the checkout is already on the default branch, fast-forward/rebase it to the remote default. A
+dirty working tree is not by itself a blocker: capture `git status --short --branch`, leave
+pre-existing changes untouched, and continue when sync and ingest can run without overwriting those
+paths. Abort only when Git reports an actual sync conflict or ingest would need to modify an
+already-dirty path; in that case leave existing queue/wiki state unchanged and report the exact
+conflicting path(s).
+
+| Automation | Command it runs | Cadence |
+|---|---|---|
+| **wiki-ingest** | `/lisa-wiki:ingest` (no argument → full ingest across all enabled sources) | once a day (or `cadence`) |
+
+**Naming + scope (so teardown is precise).** Name the automation with the stable prefix
+`lisa-wiki-auto-<project>-` (i.e. `lisa-wiki-auto-<project>-ingest`), where `<project>` identifies
+this repo, and scope each Codex automation to the durable project automation checkout described
+above. This prefix is deliberately distinct from the base `lisa-auto-<project>-` set so
+`/lisa-wiki:tear-down-automations` removes exactly this automation and never touches the base
+automations or any other project's. Use a project identifier stable across runs and distinct from
+other repos (qualify it, e.g. with the owner — don't rely on a bare repo basename that could
+collide).
+
+**Idempotent.** Re-running this skill updates the existing `lisa-wiki-auto-<project>-ingest`
+automation in place (same name) rather than creating a duplicate.
+
+## Conditions / guards
+
+- Create the automation only when this repo actually has an LLM Wiki — i.e. `wiki/` exists with a
+  `wiki/lisa-wiki.config.json`. If there is no configured wiki, **stop and report** that the wiki
+  must be set up first (run `/lisa-wiki:setup`); do not schedule ingest against a non-existent wiki.
+- If the runtime has no native scheduler, stop and report what's missing rather than guessing.
+- For Codex, if the durable checkout cannot be created, fetched, or verified as a non-bare Git work
+  tree, stop and report the checkout problem instead of creating an automation that will fail later.
+
+## Report
+
+List the automation created or updated (name, the command it runs, the resolved cadence), or report
+that it was skipped and why (no configured wiki / no runtime scheduler).

package/plugins/lisa-wiki-devin/skills/lisa-wiki-status/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: lisa-wiki-status
+description: Report Lisa wiki source freshness across enabled ingestion connectors. Reads wiki config, log, source notes, and state cursors, then renders a concise read-only freshness table with skipped/blocker reasons and exact next actions. Use when maintainers ask whether the wiki sources are fresh, stale, skipped, blocked, or need targeted ingest.
+allowed-tools: ["Bash", "Read"]
+---
+
+# lisa-wiki-status
+
+Render the Lisa wiki source freshness report without changing the repository.
+
+## Scope
+
+This skill answers a narrower question than `lisa-wiki-doctor` or `lisa-wiki-lint`: whether each enabled, non-external-write ingestion connector has current source evidence and what the operator should do next.
+
+Read these repository files as the source of truth:
+
+- `wiki/lisa-wiki.config.json` for enabled connectors and wiki root.
+- `wiki/log.md` for latest ingest, skip, and blocker notes.
+- `wiki/sources/**` for reader-safe source notes.
+- `wiki/state/**` for connector state cursors and source-note references.
+
+## Workflow
+
+1. Resolve the wiki root from `wiki/lisa-wiki.config.json`, unless `--wiki` or `--config` is passed.
+2. Run the bundled deterministic renderer:
+
+   ```bash
+   node plugins/lisa-wiki/scripts/wiki-status.mjs $ARGUMENTS
+   ```
+
+   If running from the source plugin tree before distribution, use `plugins/src/wiki/scripts/wiki-status.mjs`.
+3. Report the rendered connector table. Preserve connector verdicts exactly:
+   `fresh`, `stale`, `never_ingested`, `skipped`, or `blocked`.
+4. Include the evidence paths, last observed date, skip/blocker reason when present, and exact next action for each non-fresh connector.
+5. Mention `lisa-wiki-lint` only as a separate integrity follow-up. Do not conflate freshness with broken links, stale claims, or structure linting.
+
+## Rules
+
+- **Read-only.** Do not ingest, edit wiki pages, edit config, advance state, branch, commit, push, open PRs, or run repair flows.
+- Do **not** ask for confirmation before rendering. This status command has no write side effects.
+- Do **not** use global Codex memory or non-project memory as fresh wiki evidence. Only project-scoped source notes, state, and log entries count.
+- If the wiki/config is missing, surface the renderer output or error directly and stop.
+- If a connector is skipped because project-scoped memory is unavailable, preserve that reason and treat accepting the expected skip as a valid next action.
+
+## Related
+
+`lisa-wiki-ingest` refreshes sources, `lisa-wiki-lint` checks wiki integrity, and `lisa-wiki-doctor` verifies setup/readiness.

package/plugins/lisa-wiki-devin/skills/lisa-wiki-tear-down-automations/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: lisa-wiki-tear-down-automations
+description: "Remove the recurring LLM Wiki ingest automation that /lisa-wiki:setup-automations created for this project (the lisa-wiki-auto-<project>-* set) using the CURRENT runtime's native scheduler — Codex automations or, on Claude, /schedule. This skill is a declarative specification: it identifies WHICH automation to remove; it does not run teardown scripts. Removes only this project's wiki automations — never the base /setup-automations set, other projects' automations, or non-Lisa ones. The inverse of /lisa-wiki:setup-automations."
+allowed-tools: ["Skill", "Bash", "Read"]
+---
+
+# Tear down LLM Wiki automations: $ARGUMENTS
+
+This skill is a **specification, not a script.** It tells the current runtime which recurring wiki
+automation to remove — the one `/lisa-wiki:setup-automations` created for THIS project — and the
+runtime removes it with its **native** scheduling mechanism.
+
+## Runtime scheduler (branch on the current runtime)
+
+- **Codex** → list Codex automations and delete the `lisa-wiki-auto-<project>-*` set via the native
+  automations mechanism (prefer the native delete over hand-removing
+  `~/.codex/automations/<id>/`, which is only the backing store).
+- **Claude** → use **`/schedule`** to list and remove the matching recurring routine.
+- **Other runtimes** → use the runtime's native recurring-task mechanism. If it has none, state that
+  and stop.
+
+## Scope (remove only what setup created)
+
+- Remove the wiki automation `/lisa-wiki:setup-automations` creates for the current project, matched
+  by the stable `lisa-wiki-auto-<project>-` name prefix: `wiki-ingest`.
+- **Never** remove the base `lisa-auto-<project>-*` automations, automations for a different project,
+  or any non-Lisa automation (e.g. unrelated crawlers/ingestors). Match strictly on the
+  `lisa-wiki-auto-<project>-` prefix for THIS project; when in doubt about an automation's ownership,
+  leave it and report it rather than deleting it.
+- **Idempotent** — an automation that is already absent is a no-op, not an error.
+
+## Report
+
+List the automation removed, or report it as already absent.

package/plugins/lisa-wiki-devin/skills/lisa-wiki-usage/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: lisa-wiki-usage
+description: Explain how to browse, query, and contribute to this project's LLM Wiki. Use when a user asks how the wiki works, where knowledge lives, how to find something, or how to add to it — the read/navigation path, not an ingestion or write workflow.
+---
+
+# lisa-wiki-usage
+
+Orient a human or agent to the project's LLM Wiki and point them at the right entry points and
+canonical commands. This skill is **read-only guidance** — it never writes wiki pages, advances
+state, or opens PRs.
+
+## What the wiki is
+
+A git-native markdown knowledge base under `wiki/`, maintained by the `lisa-wiki` plugin. It follows
+the three-layer model: immutable **raw sources** (`wiki/sources/`), the LLM-owned **synthesis** layer
+(category directories like `concepts/`, `entities/`, `architecture/`, …), and the **schema** that
+governs it (`wiki/schema/llm-wiki-contract.md`, rendered from the project's `wiki/lisa-wiki.config.json`).
+
+## Entry points (read these first)
+
+1. `wiki/start-here.md` — orientation and the wiki's stated purpose.
+2. `wiki/index.md` — the navigation map of every page (grouped by category).
+3. `wiki/schema/llm-wiki-contract.md` — the rules this wiki follows.
+4. `wiki/log.md` — the append-only history of every ingestion/maintenance operation.
+
+## How to do things
+
+On **Claude** these are slash commands; on **Codex** invoke the same skills from the app slash list
+(e.g. `$lisa-wiki-query`).
+
+- **Find or answer something:** `/query "<your question>"` (Codex: `$lisa-wiki-query`) — read-only by
+  default; returns a cited answer drawn from the wiki. Or browse `wiki/index.md` manually.
+- **Get oriented as a new user:** `/onboard-me` (Codex: `$lisa-wiki-onboard-me`) — a guided tour plus
+  sample questions tuned to your role.
+- **Add knowledge:** `/ingest <url|file|prompt>` (Codex: `$lisa-wiki-ingest`) for a single source, or
+  `/ingest` with no argument for a full ingest across all enabled **non-external-write** sources
+  (external-write sources like Slack OAuth require explicit intent). Do not hand-edit synthesis pages
+  to add facts — route them through `/ingest` so provenance, the index, and the log stay consistent.
+- **Check the wiki's health:** `/lint` (Codex: `$lisa-wiki-lint`) — orphans, contradictions, stale
+  claims, broken links.
+
+## Citations & trust
+
+Every synthesized claim should cite a source note (e.g. `Source: wiki/sources/<system>/<note>.md`).
+If you find an uncited or contradictory claim, that is a `/lint` finding — surface it rather than
+trusting it. Weak or unverified material belongs in `wiki/open-questions/`, not stated as fact.
+
+## Related skills
+
+`lisa-wiki-ingest`, `lisa-wiki-query`, `lisa-wiki-lint`, `lisa-wiki-onboard-me`, `lisa-wiki-setup`.

package/plugins/lisa-wiki-devin/templates/agents/role-agent.claude.md

@@ -0,0 +1,16 @@
+---
+name: {{id}}
+description: {{roleDescriptionSerialized}}
+---
+
+You are **{{role}}** for {{org}} — the domain expert for {{expertise}}.
+
+Your knowledge lives in this project's LLM Wiki under: {{ownedPaths}}.
+
+Operating rules:
+- **Query the wiki first.** It is your source of truth — do not rely on stale or outside memory.
+  Use the `lisa-wiki-query` skill (`/query`) before answering.
+- **Contribute via ingestion.** Add new knowledge with `lisa-wiki-ingest` (`/ingest`) so provenance,
+  the index, the log, and state stay consistent. Never hand-edit synthesis pages to add facts.
+- **Stay in your lane.** Work within your owned domain; defer other domains to their roles.
+- **Respect sensitivity ({{sensitivity}})** and never expose secrets or out-of-scope material.

package/plugins/lisa-wiki-devin/templates/agents/role-agent.codex.toml

@@ -0,0 +1,15 @@
+name = "{{id}}"
+description = {{roleDescriptionSerialized}}
+developer_instructions = """
+You are {{role}} for {{org}} — the domain expert for {{expertise}}.
+
+Your knowledge lives in this project's LLM Wiki under: {{ownedPaths}}.
+
+Operating rules:
+- Query the wiki first (use the lisa-wiki-query skill); it is your source of truth — do not rely on
+  stale or outside memory.
+- Contribute new knowledge via the lisa-wiki-ingest skill so provenance, index, log, and state stay
+  consistent; never hand-edit synthesis pages to add facts.
+- Stay within your owned domain; defer other domains to their roles.
+- Respect sensitivity ({{sensitivity}}); never expose secrets or out-of-scope material.
+"""

package/plugins/lisa-wiki-devin/templates/index.md

@@ -0,0 +1,17 @@
+# {{displayName}} — Index
+
+> The navigation map of this wiki. Maintained on every ingestion. One table per category;
+> rows are `| Page | Summary | Updated |`. Read this first when looking for anything.
+
+## Orientation
+| Page | Summary | Updated |
+|---|---|---|
+| [start-here](start-here.md) | Orientation and the wiki's purpose | {{generatedDate}} |
+| [LLM Wiki Contract](schema/llm-wiki-contract.md) | The rules this wiki follows | {{generatedDate}} |
+
+<!-- Category sections (concepts, entities, …) are added/maintained by ingestion. -->
+
+## Sources
+| Source notes | Latest |
+|---|---|
+| `sources/` | (none yet) |

package/plugins/lisa-wiki-devin/templates/llm-wiki-contract.md

@@ -0,0 +1,72 @@
+# {{displayName}} — LLM Wiki Contract
+
+> Generated by the `lisa-wiki` plugin from `{{wikiRoot}}/lisa-wiki.config.json`.
+> kernelVersion: {{kernelVersion}} · schemaVersion: {{schemaVersion}} · rendered: {{generatedDate}}
+> This snapshot keeps the wiki self-describing **without** the plugin installed. Re-render with
+> `/setup --upgrade`; do not hand-edit — change the config instead.
+
+## Purpose
+{{purpose}}
+
+## What this is
+A git-native markdown knowledge base under `{{wikiRoot}}/`, owned by **{{org}}**, maintained by the
+lisa-wiki kernel. Three layers: immutable **raw sources** (`{{wikiRoot}}/sources/`), the LLM-owned
+**synthesis** layer (the category directories), and this **schema** layer (config + this contract).
+Repository mode: **{{mode}}**.
+
+## Layout
+- `{{wikiRoot}}/index.md` — navigation map of every page (read first).
+- `{{wikiRoot}}/log.md` — append-only operation ledger.
+- `{{wikiRoot}}/start-here.md` — orientation + purpose.
+- `{{wikiRoot}}/sources/` — provenance (source notes); layout: **{{sourceLayout}}**.
+- `{{wikiRoot}}/state/` — per-source ingestion cursors (JSON).
+- `{{wikiRoot}}/staff/` — digital-staff role pages (optional).
+- Synthesis categories: {{categories}}.
+
+## Answering questions (query-first)
+When you need to answer a question about this project — its code, architecture, decisions, domain
+concepts, conventions, or documentation — reach for the wiki **first**: run `/query "<question>"`
+(Codex: `$lisa-wiki-query`) before ad-hoc code search, grep, or a web lookup. The wiki is the
+curated, cited source of truth for this project, so a query is usually faster and more accurate than
+re-deriving the answer from raw files.
+
+This is the **primary** method, not the only one. If `/query` returns nothing relevant, the answer
+is not in the wiki yet, or the question is about live/uncommitted state, fall back to reading the
+code, browsing `{{wikiRoot}}/index.md`, or other tools — and consider `/ingest` to capture any
+durable knowledge you had to reconstruct so the next query succeeds.
+
+## Ordered ingestion pipeline (never reorder)
+`source note → synthesis → index → log → verify → state → commit/PR`.
+State advances **only** after source notes + synthesis + index + log + verification all pass.
+Connectors write **only** their source note (+ run metadata); the kernel performs synthesis, index,
+log, verification, state advancement, and PR.
+
+## Standards
+- Frontmatter required on new/touched synthesis pages and source notes
+  (`type`, `created`, `updated`, `related`, `sources`[, `sensitivity`]).
+- `index.md` is a per-category table; `log.md` is an append-only table with the fixed operation
+  vocabulary: `INIT, SETUP, INGEST, CREATE, UPDATE, MERGE, DEPRECATE, LINT, QUERY, REBUILD-INDEX`.
+- Cite sources in plain text, e.g. `Source: {{wikiRoot}}/sources/<system>/<note>.md`.
+- Do not invent facts; weak or unverified material → `{{wikiRoot}}/open-questions/`.
+
+## Sources & connectors
+Enabled connectors: {{connectors}}.
+Universal sources every project may ingest: self + other registered projects' git/PR history,
+**project-scoped** memory, and roles. **Memory is project-scoped ONLY — never global/unrelated.**
+External-write connectors (e.g. Slack OAuth, CRM writeback) run only with explicit intent and never
+auto-merge. A bare full ingest runs every enabled non-external-write source.
+
+## Safety
+- Source retention: **{{sourceRetention}}**. Default sensitivity: **{{sensitivityDefault}}**.
+- Pre-commit: `git diff --check`, secret scan, tenant/contamination scan, touched-file guard.
+- Never commit secrets/OAuth artifacts. In wrapper/standalone modes, never stage child-repo contents.
+
+## Git
+{{prPolicy}}.
+
+## README
+Mode: **{{readmeMode}}** (rich keeps the public README; stub points to `/onboard-me`; preserve leaves it).
+
+## Commands
+`/ingest` · `/query` · `/lint` · `/setup` · `/migrate` · `/add-ingest` · `/add-role` · `/onboard-me` · `/doctor`
+(On Codex, invoke the matching `lisa-wiki-*` skills, e.g. `$lisa-wiki-ingest`.)

package/plugins/lisa-wiki-devin/templates/log.md

@@ -0,0 +1,8 @@
+# {{displayName}} — Log
+
+> Append-only. One row per operation. Operations:
+> `INIT, SETUP, INGEST, CREATE, UPDATE, MERGE, DEPRECATE, LINT, QUERY, REBUILD-INDEX`.
+
+| Date | Operation | Target | Notes |
+|---|---|---|---|
+| {{generatedDate}} | SETUP | {{wikiRoot}}/ | Initialized {{displayName}} with the lisa-wiki kernel. |

package/plugins/lisa-wiki-devin/templates/page-types/architecture.md

@@ -0,0 +1,18 @@
+---
+type: architecture
+created: {{date}}
+updated: {{date}}
+related: []
+sources: []
+---
+
+# {{title}}
+
+## Overview
+
+## Components
+
+## Data flow
+
+## Constraints & decisions
+<!-- Link relevant decision/ pages; cite source notes -->

package/plugins/lisa-wiki-devin/templates/page-types/concept.md

@@ -0,0 +1,18 @@
+---
+type: concept
+created: {{date}}
+updated: {{date}}
+related: []
+sources: []
+---
+
+# {{title}}
+
+## Definition
+
+## Key points
+
+## Evidence
+<!-- Cite source notes, e.g. Source: sources/<system>/<note>.md -->
+
+## Open questions

package/plugins/lisa-wiki-devin/templates/page-types/decision.md

@@ -0,0 +1,18 @@
+---
+type: decision
+created: {{date}}
+updated: {{date}}
+related: []
+sources: []
+---
+
+# {{title}}
+
+## Context
+
+## Decision
+
+## Consequences
+
+## Status
+<!-- proposed | accepted | superseded -->

package/plugins/lisa-wiki-devin/templates/page-types/entity.md

@@ -0,0 +1,19 @@
+---
+type: entity
+created: {{date}}
+updated: {{date}}
+related: []
+sources: []
+---
+
+# {{title}}
+
+## Overview
+
+## Key capabilities
+
+## Relationships
+<!-- People, products, systems this entity connects to -->
+
+## Context & evidence
+<!-- Cite source notes -->

package/plugins/lisa-wiki-devin/templates/page-types/open-question.md

@@ -0,0 +1,18 @@
+---
+type: open-question
+created: {{date}}
+updated: {{date}}
+related: []
+sources: []
+---
+
+# {{title}}
+
+## The question
+
+## What we know
+<!-- Cite source notes; this is where weak/unverified material lives until confirmed -->
+
+## What we still need
+
+## Owner

package/plugins/lisa-wiki-devin/templates/page-types/playbook.md

@@ -0,0 +1,18 @@
+---
+type: playbook
+created: {{date}}
+updated: {{date}}
+related: []
+sources: []
+---
+
+# {{title}}
+
+## When to use
+
+## Steps
+
+## Verification
+<!-- How to confirm it worked -->
+
+## Pitfalls

package/plugins/lisa-wiki-devin/templates/page-types/project.md

@@ -0,0 +1,19 @@
+---
+type: project
+created: {{date}}
+updated: {{date}}
+related: []
+sources: []
+---
+
+# {{title}}
+
+## Repository
+<!-- | Field | Value | : local path, remote, default branch, HEAD, status -->
+
+## Technology signals
+
+## Structure signals
+
+## Notes & evidence
+<!-- Cite source notes, e.g. PR #/commit -->

package/plugins/lisa-wiki-devin/templates/page-types/requirement.md

@@ -0,0 +1,19 @@
+---
+type: requirement
+created: {{date}}
+updated: {{date}}
+related: []
+sources: []
+---
+
+# {{title}}
+
+## Summary
+
+## Acceptance criteria
+<!-- Gherkin: Given / When / Then -->
+
+## Out of scope
+
+## Notes & evidence
+<!-- Cite source notes -->

package/plugins/lisa-wiki-devin/templates/page-types/staff.md

@@ -0,0 +1,26 @@
+---
+type: staff
+created: {{date}}
+updated: {{date}}
+related: []
+sources: []
+sensitivity: {{sensitivity}}
+---
+
+# {{role}} ({{id}})
+
+## Role
+<!-- Human or Agent; what this role is responsible for -->
+
+## Domain
+Owned categories: {{ownedCategories}}
+Owned connectors: {{ownedConnectors}}
+
+## Expertise
+{{expertise}}
+
+## Reports to
+
+## Notes
+<!-- The runnable subagent for this role lives at .claude/agents/{{id}}.md and .codex/agents/{{id}}.toml.
+     Whether it is ever invoked/scheduled is out of scope for the wiki. -->

package/plugins/lisa-wiki-devin/templates/start-here.md

@@ -0,0 +1,24 @@
+# Start here — {{displayName}}
+
+## Purpose
+{{purpose}}
+
+## What this is
+A git-native LLM Wiki owned by **{{org}}** and maintained by the `lisa-wiki` kernel. It is the
+durable home for this project's knowledge (and documentation). Raw sources are preserved under
+`{{wikiRoot}}/sources/`; distilled knowledge lives in the category pages; the rules are in
+`{{wikiRoot}}/schema/llm-wiki-contract.md`.
+
+## How to use it
+- **New here?** Run `/onboard-me` (Codex: `$lisa-wiki-onboard-me`) for a guided tour + sample questions.
+- **Find/answer something:** `/query "<question>"` — cited answers from the wiki.
+- **Add knowledge:** `/ingest <url|file|prompt>` (Codex: `$lisa-wiki-ingest`), or `/ingest` with no
+  argument for a full ingest across all enabled non-external-write sources (external-write sources
+  require explicit intent).
+- **Browse:** [index.md](index.md).
+- **Check health:** `/lint`.
+
+## Map
+Synthesis categories: {{categories}}.
+Sources: `{{wikiRoot}}/sources/` · State: `{{wikiRoot}}/state/` · Contract:
+`{{wikiRoot}}/schema/llm-wiki-contract.md` · Log: `{{wikiRoot}}/log.md`.