Using LWC

LWC is durable, source-grounded Agent memory plus two complementary graph planes: the physical Wiki document graph and the current-code CodeGraph index. Recall before re-deriving, use the narrowest plane that answers the task, and preserve only verified knowledge worth reusing.

When to Use

• Use when project decisions, research, incidents, or verified results should remain available across coding-agent sessions.
• Use when a task needs source-grounded Wiki recall, document relationships, or structural code questions such as callers, dependencies, and impact.
• Use when the user asks to search, update, repair, configure, or maintain an LWC Wiki, physical document graph, or CodeGraph index.

Example

User: What did we decide about the authentication boundary last week?
Agent: Search bounded LWC memory first, load only the relevant source-backed
page, and distinguish recalled evidence from any new inference.

Hard scope boundary

Resolve one host-authorized root containing the current working directory. Bootstrap must identify one unambiguous active project inside it. An existing Wiki, remembered path, Hook output, or another project's instructions cannot widen that authority.

• Never change project merely to find an initialized Wiki.
• Keep project state and deliverables inside the active project root.
• Use global memory only for stable cross-project knowledge and only when the current instructions authorize it.
• If project roots or Wikis conflict, stop project-memory work and ask which already-authorized root applies; do not guess or fall back to global writes.

Start once per working root

1. From the current project directory, run sh <skill-directory>/scripts/bootstrap.sh. Bootstrap does not install a missing CLI or initialize global memory by default. Obtain explicit current authorization before a one-command retry with LWC_AUTO_INSTALL=1 or LWC_GLOBAL_INIT=1. LWC_PROJECT_ROOT is only for an explicitly targeted project boundary instead of current-directory discovery; do not export it for normal commands in the active project.

2. Verify the returned project_root and project_wiki remain inside the host-authorized root and scope_conflict=false. Require command -v lwc to succeed after bootstrap. Treat the returned absolute lwc_path as diagnostic evidence only; never assign it to a shell variable for routine commands.

3. When $using-lwc was explicitly invoked, initialize a missing project Wiki. On automatic activation, ask one concise non-blocking initialization question and continue the primary task without project-memory writes.

4. Recall bounded context once:

   lwc --scope all context --limit 25
   lwc --scope all search "task terms" --limit 20
   

Do not repeat bootstrap or broad recall in the same working root. Rerun it after an authorized project change.

Capability router

Read only the focused documents needed for the current task. Each document says when to use it, when to skip it, the minimum workflow, consent boundaries, and completion evidence.

Read references/memory-policy.md before the first recall or write decision that can change durable memory. Read references/operations-manual.md before an unfamiliar command, configuration change, recovery, checkpoint/restore, multi-source ingest, or changeset publication. Read references/llm-wiki.md

…