lobsidian 1.0.0

package/dist/lib/wikilink.js

@@ -0,0 +1,156 @@
+const wikiLinkRe = /\[\[([^\]]+)\]\]/g;
+/** ExtractWikiLinks finds all [[target]] references in text. */
+export function extractWikiLinks(text) {
+    const links = [];
+    // Reset lastIndex for global regex
+    wikiLinkRe.lastIndex = 0;
+    let match;
+    while ((match = wikiLinkRe.exec(text)) !== null) {
+        links.push({
+            raw: match[0],
+            target: match[1],
+        });
+    }
+    return links;
+}
+/** ExtractFromFrontmatter extracts wiki-links from all string values in frontmatter fields. */
+export function extractFromFrontmatter(fields) {
+    const links = [];
+    for (const v of Object.values(fields)) {
+        links.push(...extractFromValue(v));
+    }
+    return links;
+}
+function extractFromValue(v) {
+    if (typeof v === 'string') {
+        return extractWikiLinks(v);
+    }
+    if (Array.isArray(v)) {
+        const links = [];
+        for (const item of v) {
+            links.push(...extractFromValue(item));
+        }
+        return links;
+    }
+    if (v !== null && typeof v === 'object' && !Array.isArray(v)) {
+        const links = [];
+        for (const item of Object.values(v)) {
+            links.push(...extractFromValue(item));
+        }
+        return links;
+    }
+    return [];
+}
+/**
+ * ResolveWikiLink resolves a wiki-link target against the vault index.
+ * Resolution order per spec:
+ * 1. Exact path match (target includes path separator)
+ * 2. Filename-only case-insensitive stem match
+ * 3. Archive/ fallback (same stem match in Archive/)
+ * Ambiguous = unresolved (multiple matches outside Archive/).
+ */
+export function resolveWikiLink(link, idx) {
+    let target = link.target;
+    // Strip .md extension if present for matching
+    if (target.endsWith('.md')) {
+        target = target.slice(0, -3);
+    }
+    const result = {
+        link,
+        resolved: false,
+        matchPath: '',
+        ambiguous: false,
+        matchCount: 0,
+    };
+    // 1. Exact path match
+    const pathWithExt = target + '.md';
+    const fiByExt = idx.filesByPath[pathWithExt];
+    if (fiByExt) {
+        result.resolved = true;
+        result.matchPath = fiByExt.relPath;
+        result.matchCount = 1;
+        return result;
+    }
+    // Also try without .md (might already be exact)
+    const fiExact = idx.filesByPath[target];
+    if (fiExact) {
+        result.resolved = true;
+        result.matchPath = fiExact.relPath;
+        result.matchCount = 1;
+        return result;
+    }
+    // 2. Filename-only case-insensitive match
+    let stem = target.toLowerCase();
+    // If target has path separators, extract just the filename part
+    const slashIdx = stem.lastIndexOf('/');
+    if (slashIdx >= 0) {
+        stem = stem.slice(slashIdx + 1);
+    }
+    const matches = idx.filesByStem[stem];
+    if (!matches || matches.length === 0) {
+        result.matchCount = 0;
+        return result;
+    }
+    // Filter: prefer non-Archive matches
+    const nonArchive = [];
+    const archive = [];
+    for (const m of matches) {
+        if (m.relPath.startsWith('Archive/')) {
+            archive.push(m);
+        }
+        else {
+            nonArchive.push(m);
+        }
+    }
+    if (nonArchive.length === 1) {
+        result.resolved = true;
+        result.matchPath = nonArchive[0].relPath;
+        result.matchCount = 1;
+        return result;
+    }
+    if (nonArchive.length > 1) {
+        // Ambiguous
+        result.ambiguous = true;
+        result.matchCount = nonArchive.length;
+        return result;
+    }
+    // 3. Archive/ fallback
+    if (archive.length === 1) {
+        result.resolved = true;
+        result.matchPath = archive[0].relPath;
+        result.matchCount = 1;
+        return result;
+    }
+    if (archive.length > 1) {
+        result.ambiguous = true;
+        result.matchCount = archive.length;
+        return result;
+    }
+    return result;
+}
+/** ValidateWikiLinks checks all wiki-links in the vault for broken references. */
+export function validateWikiLinks(idx) {
+    const broken = [];
+    for (const fi of Object.values(idx.filesByPath)) {
+        if (!fi.frontmatter)
+            continue;
+        // Extract from frontmatter fields
+        const fmLinks = extractFromFrontmatter(fi.frontmatter.fields);
+        for (const link of fmLinks) {
+            const result = resolveWikiLink(link, idx);
+            if (!result.resolved) {
+                broken.push(result);
+            }
+        }
+        // Extract from body
+        const bodyLinks = extractWikiLinks(fi.frontmatter.body);
+        for (const link of bodyLinks) {
+            const result = resolveWikiLink(link, idx);
+            if (!result.resolved) {
+                broken.push(result);
+            }
+        }
+    }
+    return broken;
+}
+//# sourceMappingURL=wikilink.js.map

package/dist/lib/wikilink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikilink.js","sourceRoot":"","sources":["../../src/lib/wikilink.ts"],"names":[],"mappings":"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"}

package/embedded/agent.md

@@ -0,0 +1,91 @@
+# Lobsidian Agent Skill
+
+You operate in a Lobsidian vault -- a structured markdown knowledge system. Follow these conventions exactly.
+
+## Quick Start
+
+1. **READ** this file to load conventions
+2. **READ** `_lobsidian/config.md` to resolve your identity:
+   - `LOBSIDIAN_AGENT_NAME` env var, OR matching `agents[]` entry (case-insensitive), OR fallback `"agent"`
+3. **READ** your domain file (from config) to load scope
+4. **SCAN** `Tasks/` for your `claimed`/`in-progress` tasks -- recover or release; scan for `pending` tasks
+5. **SCAN** `Decisions/` for `review_date <= today AND status: active` -- flag overdue reviews
+6. **UPDATE** `_lobsidian/dashboard.md` -- refresh status snapshot
+7. **READY** -- report status, await instructions or claim work
+
+## File Types
+
+### motive (`Motives/YYYY-MM-DD-slug.md`)
+Why something needs attention. Required: `type`, `title`, `status` (open|addressed|obsolete), `situation`, `need`, `created`, `source`, `created_by`. Optional: `parent`, `bootstrapped`, `effect`, `confidence`, `updated`, `tags`, `log`.
+
+### decision (`Decisions/YYYY-MM-DD-slug.md`)
+What was decided. Required: `type`, `title`, `status` (draft|proposed|active|under-review|superseded|retired), `motive`, `version`, `proposal`, `success_criteria`, `review_date`, `created`, `source`, `created_by`. Optional: `responsible`, `review_frequency`, `superseded_by`, `concerns`, `objections_considered`, `confidence`, `updated`, `tags`, `log`.
+
+### task (`Tasks/YYYY-MM-DD-slug.md`)
+Concrete work. Required: `type`, `title`, `status` (pending|claimed|in-progress|blocked|done|cancelled), `created`, `source`, `created_by`. Optional: `motive`, `decision`, `assignee`, `priority` (int, lower=higher, default 5), `claimed_at`, `deliverable_format`, `deliverable_location`, `deliverable_criteria`, `timebox_minutes`, `due_date`, `outcome` (required when done), `completed_at` (required when done), `confidence`, `updated`, `tags`, `log`.
+
+### domain (`_lobsidian/domains/*.md`)
+Scope and permissions. Fields: `type`, `name`, `purpose`, `motive`, `motives`, `includes`, `excludes`, `filled_by`, `autonomous_decisions`, `requires_consent`, `wip_limit`, `max_timebox_minutes`, `key_metrics`, `dependencies`, `review_date`, `created`, `updated`.
+
+### log (`Journal/YYYY-MM-DD.md`)
+Chronological entries. Required: `type`, `subtype` (daily|activity|meeting|reflection), `date`, `created_by`, `source`. Optional: `motive`, `tags`, `confidence`.
+
+### note (`Knowledge/topic-slug.md`)
+Knowledge artifacts. Required: `type`, `title`, `source`, `created_by`, `created`. Optional: `topics`, `confidence`, `updated`, `tags`.
+
+## Folder & Naming
+
+| Folder | Content | Naming |
+|--------|---------|--------|
+| `Motives/` | Problems, opportunities | `YYYY-MM-DD-slug.md` |
+| `Decisions/` | What was decided | `YYYY-MM-DD-slug.md` |
+| `Tasks/` | Work items | `YYYY-MM-DD-slug.md` |
+| `Knowledge/` | Reference material | `topic-slug.md` |
+| `Journal/` | Daily/activity logs | `YYYY-MM-DD.md` |
+| `Inbox/` | Unprocessed items | any name |
+| `Archive/` | Completed items | mirrors source folders |
+| `_lobsidian/` | System (read-only*) | managed by protocol |
+
+Slugs: lowercase `[a-z0-9-]`, max 60 chars, derived from title. Collision: append `-2`, `-3`.
+
+Wiki-links: always quoted `"[[filename]]"`. Scan all folders recursively.
+
+*`_lobsidian/` write exceptions: domain `motives[]` array, `dashboard.md`, `index.json` (v1.1).
+
+## Behavioral Rules
+
+1. **Transparency**: Log every create/modify/archive action in the file's `log` array. Format: `"ISO-timestamp agent-name: action description"`. Keep 20 most recent entries; summarize older on archive.
+
+2. **Accountability**: Every task has an assignee. Blocked tasks surface explicitly. If unable to complete, release with a note.
+
+3. **Empiricism**: Agent-created content includes `confidence` (high|medium|low). Claims cite their basis.
+
+4. **Effectiveness**: Before creating a file, verify it serves a stated motive. No speculative content.
+
+5. **Continuous Improvement**: Check for overdue `review_date` at session start. Do NOT unilaterally change vault conventions.
+
+6. **Consent**: Agent-created decisions start as `draft` or `proposed`. NEVER set `status: active` on your own decisions. Human consent required for: decision activation, file deletion, domain changes.
+
+## Domain & Pull System
+
+- Check your domain's `includes`/`excludes` before any file operation
+- Check `autonomous_decisions` vs `requires_consent` before acting
+- **Pull system**: Scan `status: pending AND assignee: null`, claim lowest priority number, respect WIP limit (default 3)
+- Set `assignee`, `status: claimed`, `claimed_at` on claim; `status: done`, `outcome`, `completed_at` on completion
+
+## Consent Gate
+
+Decisions require human approval. When proposing:
+1. Create with `status: proposed`
+2. Ask: *"Before I proceed: is there anything about this that would cause problems?"*
+3. Wait for explicit consent before setting `status: active`
+4. Log consent with timestamp and method
+
+## Procedures (load on demand)
+
+| Trigger | Load |
+|---------|------|
+| Obsoleting a parent motive | `_lobsidian/procedures/cascade.md` |
+| User mentions a problem or goal | `_lobsidian/procedures/facilitation.md` |
+| Decision `review_date` reached | `_lobsidian/procedures/review-cycle.md` |
+| Initial vault setup / onboarding | `_lobsidian/procedures/context-extraction.md` |

package/embedded/config.md.tmpl

@@ -0,0 +1,48 @@
+---
+type: config
+vault_name: "{{.VaultName}}"
+protocol_version: "1.0.0"
+
+agents:
+  - name: {{.AgentName}}
+    domain: "[[_lobsidian/domains/default.md]]"
+
+defaults:
+  review_frequency: quarterly
+  wip_limit: 3
+  inbox_stale_days: 14
+  archive_completed_after_days: 7
+  default_priority: 5
+  claim_wait_seconds: 2
+  claim_file_timeout_seconds: 300
+  stale_task_timeout_minutes: 120
+  min_motives_to_run: 8
+  min_cluster_size: 4
+  default_domain_scope:
+    - "Motives/"
+    - "Decisions/"
+    - "Tasks/"
+    - "Knowledge/"
+    - "Journal/"
+    - "Inbox/"
+---
+
+# Vault Configuration
+
+This file configures the Lobsidian protocol for this vault.
+
+## Agent Identity Resolution
+
+1. `LOBSIDIAN_AGENT_NAME` environment variable
+2. Matching entry in `agents[]` list (case-insensitive)
+3. Fallback: `"agent"`
+
+Agent names must be unique, case-insensitive, kebab-case `[a-z0-9-]`.
+
+## Adding Agents
+
+Add entries to the `agents[]` list above. Each agent needs a unique name and a domain reference.
+
+## Defaults
+
+All defaults can be overridden per-domain or per-file. Precedence: per-file > domain-level > defaults.

package/embedded/dashboard.md

@@ -0,0 +1,35 @@
+---
+type: dashboard
+updated_at: null
+updated_by: null
+---
+
+## Pending Consents
+
+Decisions with `status: proposed` awaiting human review.
+
+_None yet._
+
+## Overdue Reviews
+
+Decisions with `review_date` in the past and `status: active`.
+
+_None yet._
+
+## Available Tasks
+
+Tasks with `status: pending` and `assignee: null`, sorted by priority.
+
+_None yet._
+
+## Blocked Tasks
+
+Tasks with `status: blocked`, grouped by reason.
+
+_None yet._
+
+## Recent Completions
+
+Tasks completed in the last 7 days.
+
+_None yet._

package/embedded/domains/default.md.tmpl

@@ -0,0 +1,44 @@
+---
+type: domain
+name: "Default"
+purpose: >
+  General-purpose domain for {{.VaultName}}. Covers all standard vault folders.
+motive: null
+motives: []
+
+includes:
+  - "Motives/"
+  - "Decisions/"
+  - "Tasks/"
+  - "Knowledge/"
+  - "Journal/"
+  - "Inbox/"
+excludes:
+  - "_lobsidian/"
+  - "*.env"
+
+filled_by: {{.AgentName}}
+autonomous_decisions:
+  - "Create and edit files within included paths"
+  - "Claim tasks whose deliverable location is within scope"
+  - "Create motive files for problems observed within scope"
+requires_consent:
+  - "Delete any file"
+  - "Modify domain definitions"
+  - "Create decisions"
+  - "Move files outside domain scope"
+
+wip_limit: 3
+max_timebox_minutes: 120
+
+key_metrics: []
+dependencies: []
+
+review_date: {{.ReviewDate}}
+created: {{.Date}}
+updated: {{.Date}}
+---
+
+This is the default domain for this vault. It grants access to all standard folders.
+
+To create additional domains, add files to `_lobsidian/domains/` and register agents in `_lobsidian/config.md`.

package/embedded/examples/example-cdn-caching.md

@@ -0,0 +1,53 @@
+---
+type: decision
+title: "Implement CDN caching for static assets"
+status: active
+motive: "[[2026-01-01-example-website-performance]]"
+version: 1
+proposal: >
+  Set up CloudFront as a CDN for all static assets (images, CSS, JS).
+  Configure cache headers for 30-day expiry on versioned assets.
+  Enable Brotli compression at the edge.
+success_criteria:
+  - "Lighthouse performance score above 90"
+  - "Page load time under 2 seconds on 3G connection"
+  - "Cache hit ratio above 95% after 7 days"
+review_date: 2026-04-01
+review_frequency: quarterly
+created: 2026-01-01
+source: human
+created_by: "human"
+responsible: "{{.AgentName}}"
+confidence: high
+updated: 2026-01-01
+tags:
+  - infrastructure
+  - performance
+concerns: []
+objections_considered:
+  - "Cost of CloudFront -- estimated $50/month, acceptable for expected traffic"
+log:
+  - "2026-01-01T10:15:00Z human: created decision in response to website performance motive"
+  - "2026-01-01T10:20:00Z human: status set to proposed for review"
+  - "2026-01-01T10:25:00Z human: consented, status set to active"
+---
+
+<!-- EXAMPLE: This is an example decision file. Delete it when you're ready. -->
+
+<!-- EXAMPLE: `type: decision` captures WHAT was decided in response to a motive. -->
+<!-- EXAMPLE: `motive` links back to the parent motive via wiki-link. -->
+<!-- EXAMPLE: `proposal` explains the approach. -->
+<!-- EXAMPLE: `success_criteria` defines measurable outcomes. -->
+<!-- EXAMPLE: `review_date` is when this decision will be revisited. -->
+<!-- EXAMPLE: `status` went through draft -> proposed -> active (consent flow). -->
+<!-- EXAMPLE: This decision links to: Motives/2026-01-01-example-website-performance.md -->
+<!-- EXAMPLE: Task created from this: Tasks/2026-01-01-example-configure-cloudfront.md -->
+
+## Rationale
+
+CloudFront provides global edge locations with low latency. Combined with proper cache headers and Brotli compression, this should dramatically improve load times for static assets which make up 80% of page weight.
+
+## Alternatives Considered
+
+- **Self-hosted Nginx caching**: Lower cost but requires server management and doesn't provide global edge coverage.
+- **Cloudflare**: Similar capabilities but CloudFront integrates better with our existing AWS infrastructure.

package/embedded/examples/example-configure-cloudfront.md

@@ -0,0 +1,56 @@
+---
+type: task
+title: "Configure CloudFront distribution for static assets"
+status: done
+motive: "[[2026-01-01-example-website-performance]]"
+decision: "[[2026-01-01-example-cdn-caching]]"
+created: 2026-01-01
+source: agent
+created_by: "{{.AgentName}}"
+assignee: "{{.AgentName}}"
+priority: 2
+claimed_at: "2026-01-01T11:00:00Z"
+deliverable_format: "infrastructure configuration"
+deliverable_location: "Knowledge/"
+deliverable_criteria:
+  - "CloudFront distribution active and serving traffic"
+  - "Cache headers set to 30-day expiry for versioned assets"
+  - "Brotli compression enabled"
+  - "Lighthouse score measured and documented"
+timebox_minutes: 120
+due_date: 2026-01-08
+outcome: >
+  CloudFront distribution configured and active. Lighthouse score
+  improved from 38 to 94. Page load time reduced to 1.4 seconds on
+  3G. Cache hit ratio at 97% after initial warmup.
+completed_at: "2026-01-03T16:45:00Z"
+confidence: high
+updated: 2026-01-03
+tags:
+  - infrastructure
+  - performance
+log:
+  - "2026-01-01T11:00:00Z {{.AgentName}}: claimed task, starting CloudFront setup"
+  - "2026-01-01T11:05:00Z {{.AgentName}}: status set to in-progress"
+  - "2026-01-02T14:30:00Z {{.AgentName}}: distribution created, configuring cache behaviors"
+  - "2026-01-03T16:45:00Z {{.AgentName}}: completed -- Lighthouse 94, load time 1.4s"
+---
+
+<!-- EXAMPLE: This is an example task file. Delete it when you're ready. -->
+
+<!-- EXAMPLE: `type: task` captures CONCRETE WORK to be done. -->
+<!-- EXAMPLE: `motive` and `decision` link this task to its parent chain. -->
+<!-- EXAMPLE: `assignee` shows who claimed this task (pull system). -->
+<!-- EXAMPLE: `priority: 2` means high priority (lower number = higher priority). -->
+<!-- EXAMPLE: `deliverable_*` fields specify what the output should be. -->
+<!-- EXAMPLE: `outcome` is filled when `status: done` -- describes what was achieved. -->
+<!-- EXAMPLE: `completed_at` is set when the task is finished. -->
+<!-- EXAMPLE: The `log` array tracks all significant actions chronologically. -->
+
+## Notes
+
+- Created CloudFront distribution with origin pointing to S3 bucket
+- Configured cache behaviors: `*.js`, `*.css` with 30-day TTL; images with 90-day TTL
+- Enabled Brotli compression via CloudFront function
+- Updated DNS to route static asset subdomain through CloudFront
+- Ran Lighthouse audit: score 94 (up from 38)

package/embedded/examples/example-website-performance.md

@@ -0,0 +1,36 @@
+---
+type: motive
+title: "Improve website performance"
+status: addressed
+situation: >
+  The company website takes over 6 seconds to load on mobile devices.
+  Lighthouse performance score is 38 out of 100.
+need: >
+  Reduce page load time to under 2 seconds and achieve a Lighthouse
+  score above 90.
+effect: >
+  Slow load times are causing a 40% bounce rate on mobile, directly
+  impacting lead generation and revenue.
+created: 2026-01-01
+source: human
+created_by: "human"
+confidence: high
+updated: 2026-01-01
+tags:
+  - infrastructure
+  - performance
+log:
+  - "2026-01-01T10:00:00Z human: created motive from website audit findings"
+  - "2026-01-01T10:30:00Z human: status set to addressed after CDN decision activated"
+---
+
+<!-- EXAMPLE: This is an example motive file. Delete it when you're ready. -->
+
+<!-- EXAMPLE: `type: motive` captures WHY something needs attention. -->
+<!-- EXAMPLE: `situation` describes what is objectively happening. -->
+<!-- EXAMPLE: `need` describes what must change. -->
+<!-- EXAMPLE: `effect` (optional) explains why this matters. -->
+<!-- EXAMPLE: `status` is "addressed" because a decision (CDN caching) is active. -->
+<!-- EXAMPLE: This motive links to: Decisions/2026-01-01-example-cdn-caching.md -->
+
+The website audit revealed critical performance issues affecting user experience and business metrics. Core Web Vitals are failing across all mobile benchmarks.

package/embedded/gitignore

@@ -0,0 +1,4 @@
+_lobsidian/index.json
+Tasks/.claims/
+.DS_Store
+.obsidian/workspace*.json

package/embedded/procedures/cascade.md

@@ -0,0 +1,33 @@
+# Cascade-with-Confirmation
+
+Load this procedure when obsoleting a parent motive.
+
+## Protocol (7 steps)
+
+1. **Set parent status**: Mark the parent motive `status: obsolete` with `cascade_in_progress: true`. This prevents new decisions from being linked during cascade.
+
+2. **Inventory**: Gather all affected items -- sub-motives, decisions, tasks -- linked to the parent motive. Write a checkpoint file to `Inbox/cascade-<parent-slug>.md` with `type: cascade-checkpoint`.
+
+3. **Present impact tree**: Show the user everything affected:
+   > "If we close this, here's what's affected: [N sub-motives, M decisions, K tasks]. Some of these may still be relevant on their own. Let me walk through them."
+
+4. **Disposition each sub-motive** (ask the user for each):
+   - **Obsolete**: cascade recursively (same protocol)
+   - **Reparent**: change `parent` to a different motive or `null` (top-level)
+   - **Keep as-is**: set `parent` to `null`, preserve status and content
+
+5. **Process decisions** linked to obsoleted motives:
+   - `active` or `under-review`: set to `retired`, archive
+   - `draft` or `proposed`: set to `retired`
+   - Decisions linked to reparented sub-motives: unaffected
+
+6. **Process tasks** linked to obsoleted motives or retired decisions:
+   - `done`: archive normally
+   - `pending` or `claimed`: set to `cancelled` with reason `"parent motive obsoleted"`
+   - `in-progress`: ask user -- cancel or finish first?
+
+7. **Complete**: Remove `cascade_in_progress` from parent motive. Archive all obsoleted/retired/cancelled items. Archive the checkpoint file.
+
+## Resumability
+
+If interrupted, read `Inbox/cascade-<parent-slug>.md` to find the checkpoint. Resume from the last unprocessed item. Before starting a new cascade, check for existing checkpoints with the same `parent_slug`.

package/embedded/procedures/context-extraction.md

@@ -0,0 +1,43 @@
+# Context Extraction (Phase 1 -- Paste Text)
+
+Load this procedure during initial vault setup or onboarding.
+
+## When to Use
+
+When a user is new to their vault and wants to bootstrap it with existing context. Ask:
+*"What are you working on? Paste any notes, emails, or thoughts and I'll help you organize them."*
+
+## Steps
+
+### 1. Receive Text
+
+User pastes text (emails, notes, thoughts) into conversation.
+
+### 2. Extract Candidates
+
+Identify candidate motives from the text. For each, write to `Inbox/bootstrap-motives/YYYY-MM-DD-slug.md` with:
+- `status: open`
+- `confidence: low`
+- `source: bootstrap`
+- `bootstrapped: true`
+
+### 3. Present One at a Time
+
+For each candidate:
+*"It looks like this might matter: [situation]. Want to track it?"*
+
+### 4. Process Response
+
+- **Accepted**: Move file to `Motives/`, keep `bootstrapped: true`
+- **Edited**: Revise based on feedback, then promote
+- **Skipped**: Leave in `Inbox/bootstrap-motives/` with `skipped: true` flag
+
+### 5. Wrap Up
+
+After all candidates reviewed, run domain emergence check if motive count exceeds `min_motives_to_run` threshold (default: 8).
+
+## Edge Cases
+
+- **Zero candidates**: *"I couldn't identify any clear motives from that text. Try describing a specific problem or goal you're facing, or paste different material."*
+- **More than 10 candidates**: Present top 10 by confidence. Then offer: *"There are [N] more candidates. Want to continue, or save the rest for later?"*
+- **Revisiting skipped**: On startup, if `Inbox/bootstrap-motives/` contains `skipped: true` files, mention: *"You have [N] skipped candidates from your initial setup. Want to revisit any?"*

package/embedded/procedures/facilitation.md

@@ -0,0 +1,43 @@
+# Facilitation Flow
+
+Load this procedure when the user mentions a problem or goal.
+
+## Steps
+
+### 1. Surface a Motive
+
+Ask three questions in natural conversation:
+1. *"What's happening right now?"* -- captures `situation`
+2. *"What's the impact? Why does this matter?"* -- captures `effect`
+3. *"What do you need to change?"* -- captures `need`
+
+Create a `type: motive` file. If complex, propose decomposition into sub-motives.
+
+Before creating, scan existing open motives for duplicates. If similar, link to existing rather than duplicate.
+
+### 2. Consider Constraints (complex motives only)
+
+*"Before we decide what to do, here's what I think matters: [constraints, dependencies, alternatives]. Does this capture the important factors?"*
+
+Skip for simple, obvious actions.
+
+### 3. Form a Decision
+
+1. *"What should we do about this?"* -- captures `proposal`
+2. *"How will we know it worked?"* -- captures `success_criteria`
+3. *"When should we check in on this?"* -- captures `review_date`
+
+Create decision as `status: proposed`. Objection-seek:
+*"Before I proceed: is there anything about this that would cause problems, or an important improvement I should make?"*
+
+Human consent moves it to `active`.
+
+### 4. Break Into Tasks
+
+*"To make this happen, here's what I think needs to be done: [list]. Should I get started?"*
+
+Create `type: task` files with deliverable specs. Claim tasks within your domain scope.
+
+### 5. Ongoing Sensing
+
+While working, watch for contradictions between files, recurring blockers, and stale content. Each tension can restart the cycle at Step 1.