smartlisa 0.1.0 → 0.1.7

package/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "lisa",
+  "description": "Project planning with milestones, epics, and stories. Break down work, track progress, and implement with full context.",
+  "version": "0.1.7",
+  "author": {
+    "name": "Rodrigo Klosowski",
+    "url": "https://rklosowski.com/"
+  }
+}

package/README.md

@@ -16,10 +16,35 @@ Lisa is the smart one. She breaks down complex projects into **Milestones → Ep
 
 ## Installation
 
+### CLI Tool
+
 ```bash
 npm install -g smartlisa
 ```
 
+### Claude Code Skills
+
+Lisa works as a Claude Code skill. Choose one installation method:
+
+**Via Plugin (Recommended)**
+```bash
+/plugin install github:klosowsk/lisa
+```
+
+**As Project Skills** (anyone cloning repo gets them)
+```bash
+# Copy to your project
+cp -r path/to/lisa/skills/lisa your-project/.claude/skills/
+cp -r path/to/lisa/skills/lisa-work your-project/.claude/skills/
+```
+
+**As Personal Skills** (available in all your projects)
+```bash
+# Symlink to your personal skills directory
+ln -s $(pwd)/skills/lisa ~/.claude/skills/lisa
+ln -s $(pwd)/skills/lisa-work ~/.claude/skills/lisa-work
+```
+
 ## Using with Claude Code
 
 Lisa is a Claude Code skill. Just ask:

package/dist/cli.js

@@ -468,7 +468,6 @@ var LisaError = class extends Error {
     this.name = "LisaError";
   }
 };
-var RalphError = LisaError;
 function generateId(prefix) {
   return `${prefix}-${Date.now().toString(36)}-${Math.random().toString(36).substring(2, 6)}`;
 }
@@ -582,7 +581,6 @@ import * as fs from "fs/promises";
 import * as path from "path";
 import YAML from "yaml";
 var LISA_DIR = ".lisa";
-var RALPH_DIR = LISA_DIR;
 var FileSystemStateAdapter = class {
   rootDir;
   lisaDir;
@@ -842,7 +840,7 @@ var StateManager = class {
   // Path Helpers
   // --------------------------------------------------------------------------
   getPath(relativePath) {
-    return path2.join(this.adapter.getRootDir(), RALPH_DIR, relativePath);
+    return path2.join(this.adapter.getRootDir(), LISA_DIR, relativePath);
   }
   getEpicDir(epicId, slug) {
     return this.getPath(path2.join(PATHS.epics.dir, `${epicId}-${slug}`));
@@ -1130,7 +1128,7 @@ var StateManager = class {
   async assembleProjectContext() {
     const project = await this.readProject();
     if (!project) {
-      throw new RalphError("Project not initialized", "NOT_INITIALIZED");
+      throw new LisaError("Project not initialized", "NOT_INITIALIZED");
     }
     return {
       project,
@@ -1148,7 +1146,7 @@ var StateManager = class {
     const index = await this.readMilestoneIndex();
     const milestone = index?.milestones.find((m) => m.id === milestoneId);
     if (!milestone) {
-      throw new RalphError(`Milestone ${milestoneId} not found`, "NOT_FOUND");
+      throw new LisaError(`Milestone ${milestoneId} not found`, "NOT_FOUND");
     }
     const milestoneDiscovery = await this.readMilestoneDiscovery(milestoneId);
     const siblingEpics = [];
@@ -1182,18 +1180,18 @@ var StateManager = class {
     const epicDirs = await this.listEpicDirs();
     const epicDir = epicDirs.find((d) => d.startsWith(`${epicId}-`));
     if (!epicDir) {
-      throw new RalphError(`Epic ${epicId} not found`, "NOT_FOUND");
+      throw new LisaError(`Epic ${epicId} not found`, "NOT_FOUND");
     }
     const slug = epicDir.split("-").slice(1).join("-");
     const epic = await this.readEpic(epicId, slug);
     if (!epic) {
-      throw new RalphError(`Epic ${epicId} not found`, "NOT_FOUND");
+      throw new LisaError(`Epic ${epicId} not found`, "NOT_FOUND");
     }
     const projectContext = await this.assembleProjectContext();
     const index = await this.readMilestoneIndex();
     const milestone = index?.milestones.find((m) => m.id === epic.milestone);
     if (!milestone) {
-      throw new RalphError(`Milestone ${epic.milestone} not found`, "NOT_FOUND");
+      throw new LisaError(`Milestone ${epic.milestone} not found`, "NOT_FOUND");
     }
     const milestoneDiscovery = await this.readMilestoneDiscovery(epic.milestone);
     const epicDiscovery = await this.readEpicDiscovery(epicId, slug);
@@ -1232,19 +1230,19 @@ var StateManager = class {
     const epicDirs = await this.listEpicDirs();
     const epicDir = epicDirs.find((d) => d.startsWith(`${epicId}-`));
     if (!epicDir) {
-      throw new RalphError(`Epic ${epicId} not found`, "NOT_FOUND");
+      throw new LisaError(`Epic ${epicId} not found`, "NOT_FOUND");
     }
     const slug = epicDir.split("-").slice(1).join("-");
     const prd = await this.readPrd(epicId, slug);
     if (!prd) {
-      throw new RalphError(
+      throw new LisaError(
         `PRD not found for ${epicId}. Generate PRD first.`,
         "MISSING_PRD"
       );
     }
     const architecture = await this.readArchitecture(epicId, slug);
     if (!architecture) {
-      throw new RalphError(
+      throw new LisaError(
         `Architecture not found for ${epicId}. Generate architecture first.`,
         "MISSING_ARCH"
       );
@@ -1746,7 +1744,7 @@ function getHowGuidance(storyId, hasArchitecture) {
 // src/core/commands/status.ts
 async function overview(state) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found. Run 'discover init' first.", "NOT_INITIALIZED");
+    return error("No Lisa project found. Run 'discover init' first.", "NOT_INITIALIZED");
   }
   const project = await state.readProject();
   const index = await state.readMilestoneIndex();
@@ -1820,7 +1818,7 @@ async function overview(state) {
     }
   };
   const sections = [
-    section.header("Ralph Status"),
+    section.header("Lisa Status"),
     section.subheader(`Project: ${project.name}`),
     section.dim(`  Status: ${project.status}`),
     section.dim(`  Updated: ${timeAgo(project.updated)}`)
@@ -1902,7 +1900,7 @@ async function overview(state) {
 }
 async function board(state, options = {}) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   const allStories = [];
   const epicDirs = await state.listEpicDirs();
@@ -1935,7 +1933,7 @@ async function board(state, options = {}) {
     blocked: columns.blocked,
     deferred: columns.deferred
   };
-  const sections = [section.header("Ralph Board")];
+  const sections = [section.header("Lisa Board")];
   if (allStories.length === 0) {
     sections.push(section.info("No stories found."));
     return success(data, sections);
@@ -2068,7 +2066,7 @@ async function story(state, options) {
 }
 async function context(state, options = {}) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   const { target, full, format } = options;
   if (!target) {
@@ -2780,8 +2778,8 @@ async function init(state, options) {
   const projectName = options.name || "Untitled Project";
   const project = await state.initialize(projectName);
   const sections = [
-    section.header("Initializing Ralph"),
-    section.success(`Created .ralph/ directory`),
+    section.header("Initializing Lisa"),
+    section.success(`Created .lisa/ directory`),
     section.success(`Project: ${project.name}`),
     section.success(`ID: ${project.id}`),
     section.blank(),
@@ -2806,7 +2804,7 @@ async function init(state, options) {
 }
 async function status(state) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found. Run 'discover init' first.", "NOT_INITIALIZED");
+    return error("No Lisa project found. Run 'discover init' first.", "NOT_INITIALIZED");
   }
   const context2 = await state.readDiscoveryContext();
   const constraints = await state.readConstraints();
@@ -2874,7 +2872,7 @@ async function status(state) {
 }
 async function start(state, options = {}) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found. Run 'discover init' first.", "NOT_INITIALIZED");
+    return error("No Lisa project found. Run 'discover init' first.", "NOT_INITIALIZED");
   }
   const history = await state.readDiscoveryHistory();
   const context2 = await state.readDiscoveryContext();
@@ -2956,7 +2954,7 @@ async function start(state, options = {}) {
 }
 async function addEntry(state, options) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   let history = await state.readDiscoveryHistory();
   if (!history) {
@@ -2982,7 +2980,7 @@ async function addEntry(state, options) {
 }
 async function complete(state) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   const history = await state.readDiscoveryHistory();
   if (!history) {
@@ -3041,7 +3039,7 @@ async function findMilestoneById(state, milestoneId) {
 }
 async function element(state, options) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   const { elementType, elementId } = options;
   if (elementType === "epic") {
@@ -3099,7 +3097,7 @@ async function element(state, options) {
 }
 async function addElementEntry(state, options) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   const entry = {
     timestamp: now(),
@@ -3157,7 +3155,7 @@ function updateElementDiscoveryFromEntry(discovery, entry, question) {
 }
 async function completeElement(state, options) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   if (options.elementType === "epic") {
     const epicInfo = await findEpicByIdOrSlug(state, options.elementId);
@@ -3461,7 +3459,7 @@ function getStoriesGuidance(ctx) {
 // src/core/commands/plan.ts
 async function showMilestones(state) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   const index = await state.readMilestoneIndex();
   const context2 = await state.readDiscoveryContext();
@@ -3531,7 +3529,7 @@ async function showMilestones(state) {
 }
 async function addMilestone(state, options) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   let index = await state.readMilestoneIndex();
   if (!index) {
@@ -3557,7 +3555,7 @@ async function addMilestone(state, options) {
 }
 async function showEpics(state, options = {}) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   const index = await state.readMilestoneIndex();
   if (!index?.milestones || index.milestones.length === 0) {
@@ -3661,7 +3659,7 @@ async function showEpics(state, options = {}) {
 }
 async function addEpic(state, options) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   const index = await state.readMilestoneIndex();
   if (!index) {
@@ -3737,7 +3735,7 @@ async function addEpic(state, options) {
 }
 async function planEpic(state, options) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   const ctx = await state.assembleEpicContext(options.epicId);
   const epicDirs = await state.listEpicDirs();
@@ -4331,7 +4329,7 @@ function getDismissFeedbackGuidance(feedbackId) {
 // src/core/commands/feedback.ts
 async function markStory(state, options) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   const parsed = parseStoryId(options.storyId);
   if (!parsed) {
@@ -4399,7 +4397,7 @@ async function markStory(state, options) {
 }
 async function addFeedback(state, options) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   const parsed = parseStoryId(options.storyId);
   if (!parsed) {
@@ -4450,7 +4448,7 @@ async function addFeedback(state, options) {
 }
 async function listFeedback(state) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   const feedbackQueue = await state.readFeedbackQueue();
   const stuckQueue = await state.readStuckQueue();
@@ -4516,7 +4514,7 @@ async function listFeedback(state) {
 }
 async function resolveFeedback(state, options) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   const feedbackQueue = await state.readFeedbackQueue();
   if (!feedbackQueue) {
@@ -4558,7 +4556,7 @@ async function resolveFeedback(state, options) {
 }
 async function dismissFeedback(state, options) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   const feedbackQueue = await state.readFeedbackQueue();
   if (!feedbackQueue) {
@@ -5032,7 +5030,7 @@ async function validateCoverageInternal(state) {
 }
 async function runFullValidation(state) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   const issues = [];
   const sections = [section.header("Validation")];
@@ -5159,7 +5157,7 @@ async function runFullValidation(state) {
 }
 async function validateLinks(state) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   const linksResult = await validateLinksInternal(state);
   await state.writeLinks(linksResult);
@@ -5195,7 +5193,7 @@ async function validateLinks(state) {
 }
 async function validateCoverage(state) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   const coverageResult = await validateCoverageInternal(state);
   await state.writeCoverage(coverageResult);
@@ -5257,7 +5255,7 @@ async function validateCoverage(state) {
 }
 async function validateEpic(state, options) {
   if (!await state.isInitialized()) {
-    return error("No Ralph project found.", "NOT_INITIALIZED");
+    return error("No Lisa project found.", "NOT_INITIALIZED");
   }
   const epicDirs = await state.listEpicDirs();
   const epicDir = epicDirs.find((d) => d.startsWith(`${options.epicId}-`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smartlisa",
-  "version": "0.1.0",
+  "version": "0.1.7",
   "description": "AI-powered planning system for Claude Code",
   "type": "module",
   "license": "MIT",
@@ -38,9 +38,11 @@
   },
   "files": [
     "dist",
-    ".claude"
+    ".claude-plugin",
+    "skills"
   ],
   "scripts": {
+    "init:claude": "node scripts/init-claude.js",
     "lisa": "tsx src/adapters/cli/index.ts",
     "build": "node esbuild.config.js",
     "build:watch": "node esbuild.config.js --watch",
@@ -53,7 +55,10 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
-    "ci": "npm run typecheck && npm run lint && npm run test"
+    "ci": "npm run typecheck && npm run lint && npm run test",
+    "version:patch": "node scripts/bump-version.js patch",
+    "version:minor": "node scripts/bump-version.js minor",
+    "version:major": "node scripts/bump-version.js major"
   },
   "dependencies": {
     "chalk": "^5.3.0",

package/skills/lisa/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: lisa
+description: Plan and organize projects into milestones, epics, and stories. Use when breaking down work, creating roadmaps, planning features, asking "what should I work on?", "lisa status", "show me the board", organizing a project, or when user wants to scope and structure development work. Also triggers on "help me plan", "break this down", "create a roadmap", or "add milestone/epic/story".
+user-invocable: true
+---
+
+# Lisa - Planning Mode
+
+Plan and organize projects into milestones, epics, and stories.
+
+## Quick Start
+
+```bash
+# Check project status
+lisa status
+
+# Start a new project
+lisa discover init "Project Name"
+
+# View the board
+lisa status board
+```
+
+## Workflow
+
+### New Project
+
+1. **Ask for project name** - Confirm what they're building
+2. **Initialize**: `lisa discover init "Project Name"`
+3. **Check for existing code** - Read key files to understand patterns
+4. **Discovery conversation** - Natural Q&A about problem, vision, constraints
+   - For brownfield: suggest answers based on what you read
+
+### Existing Project
+
+1. **Check status**: `lisa status`
+2. **View board**: `lisa status board`
+3. **Add to plan** or **work on stories** as needed
+
+## Commands Reference
+
+| Action | Command |
+|--------|---------|
+| Project overview | `lisa status` |
+| Kanban board | `lisa status board` |
+| Story details | `lisa status show <id>` |
+| Start discovery | `lisa discover init "Name"` |
+| Continue discovery | `lisa discover` |
+| View milestones | `lisa plan milestones` |
+| Add milestone | `lisa plan add-milestone --name 'Name' --description 'Desc'` |
+| Add epic | `lisa plan add-epic --milestone M1 --name 'Name' --description 'Desc'` |
+| Generate stories | `lisa plan stories E1` |
+| Mark progress | `lisa feedback mark <id> <status>` |
+| Validate plan | `lisa validate` |
+
+## ID Formats
+
+| Type | Format | Example |
+|------|--------|---------|
+| Milestone | `M#` | `M1` |
+| Epic | `E#` | `E1` |
+| Story | `E#.S#` | `E1.S2` |
+
+## References
+
+- [commands.md](references/commands.md) - Full command reference
+- [examples.md](references/examples.md) - Workflow examples

package/skills/lisa/references/commands.md

@@ -0,0 +1,201 @@
+# Lisa Command Reference
+
+Complete reference for all Lisa CLI commands. Use `--help` with any command for quick help.
+
+## Discovery Commands
+
+Gather project context through guided discovery sessions.
+
+```bash
+lisa discover [subcommand] [options]
+```
+
+| Subcommand | Description |
+|------------|-------------|
+| *(none)* | Start or continue discovery session |
+| `init <name>` | Initialize new project |
+| `status` | Show discovery progress and gaps |
+| `complete` | Mark discovery phase complete |
+| `add-entry` | Add discovery entry manually |
+| `epic <id>` | Start discovery for specific epic |
+| `milestone <id>` | Start discovery for milestone |
+
+### Discovery Options
+
+| Option | Description |
+|--------|-------------|
+| `--quick` | Essentials only (problem, vision, success) |
+| `--standard` | Balanced depth (default) |
+| `--deep` | Comprehensive discovery |
+
+### Add Entry Options
+
+| Option | Description |
+|--------|-------------|
+| `--category <cat>` | Category: `problem`, `goals`, `users`, `constraints`, `scope`, `technical`, `risks`, `success` |
+| `--question '<q>'` | The discovery question |
+| `--answer '<a>'` | The answer/information |
+
+---
+
+## Plan Commands
+
+Create and manage roadmap artifacts.
+
+```bash
+lisa plan [subcommand] [options]
+```
+
+| Subcommand | Description |
+|------------|-------------|
+| *(none)* | Show milestones |
+| `milestones` | List all milestones |
+| `add-milestone` | Add new milestone |
+| `epics [M1]` | List epics (optionally filter by milestone) |
+| `add-epic` | Add new epic to milestone |
+| `epic <id>` | View/plan specific epic |
+| `stories <id>` | List stories for epic |
+
+### Add Milestone Options
+
+| Option | Description |
+|--------|-------------|
+| `--name '<name>'` | Milestone name (required) |
+| `--description '<desc>'` | Milestone description (required) |
+
+### Add Epic Options
+
+| Option | Description |
+|--------|-------------|
+| `--milestone <M1>` | Parent milestone ID (required) |
+| `--name '<name>'` | Epic name (required) |
+| `--description '<desc>'` | Epic description (required) |
+
+---
+
+## Status Commands
+
+View project state and story details.
+
+```bash
+lisa status [subcommand] [options]
+```
+
+| Subcommand | Description |
+|------------|-------------|
+| *(none)* | Project overview with phase and progress |
+| `board [epic]` | Kanban board (optionally filter by epic) |
+| `show <id>` | Detailed story information |
+| `context [target]` | Context for project, milestone, epic, or story |
+| `why <id>` | Explain story lineage (trace requirements) |
+| `how <id>` | Implementation guidance |
+
+### Status Options
+
+| Option | Description |
+|--------|-------------|
+| `--full` | Full output without truncation |
+| `--format json` | Output in JSON format |
+
+### ID Formats
+
+| Format | Example | Description |
+|--------|---------|-------------|
+| Milestone | `M1` | Milestone 1 |
+| Epic | `E1` | Epic 1 |
+| Story | `E1.S2` | Epic 1, Story 2 |
+
+---
+
+## Feedback Commands
+
+Track progress and manage feedback items.
+
+```bash
+lisa feedback [subcommand] [options]
+```
+
+| Subcommand | Description |
+|------------|-------------|
+| *(none)* | List all pending feedback items |
+| `mark <id> <status>` | Update story status |
+| `add <id>` | Add feedback to story |
+| `resolve <fb-id>` | Mark feedback as resolved |
+| `dismiss <fb-id>` | Dismiss feedback without action |
+
+### Story Statuses
+
+| Status | Description |
+|--------|-------------|
+| `todo` | Not started |
+| `assigned` | Assigned to someone |
+| `in_progress` | Work in progress |
+| `review` | In review |
+| `done` | Completed |
+| `blocked` | Blocked by dependency/issue |
+| `deferred` | Postponed to later |
+
+### Feedback Types
+
+| Type | Description |
+|------|-------------|
+| `blocker` | Something blocking progress |
+| `gap` | Missing information or requirement |
+| `scope` | Scope change or clarification needed |
+| `conflict` | Conflicting requirements |
+| `question` | Question needing answer |
+
+### Feedback Options
+
+| Option | Description |
+|--------|-------------|
+| `--reason '<text>'` | Reason for status change (mark) |
+| `--type <type>` | Feedback type (add) |
+| `--message '<text>'` | Feedback message (add) |
+| `--resolution '<text>'` | Resolution note (resolve) |
+
+---
+
+## Validate Commands
+
+Check plan integrity and coverage.
+
+```bash
+lisa validate [subcommand]
+```
+
+| Subcommand | Description |
+|------------|-------------|
+| *(none)* | Run full validation suite |
+| `links` | Check all cross-references |
+| `coverage` | Check requirement coverage |
+| `epic <id>` | Validate specific epic |
+
+### What Gets Validated
+
+- All story IDs reference valid epics
+- All epic IDs reference valid milestones
+- No orphaned or dangling references
+- Requirements have implementing stories
+- Stories have acceptance criteria
+- Epic scope is complete and consistent
+
+---
+
+## Global Options
+
+Available on all commands:
+
+| Option | Description |
+|--------|-------------|
+| `--help`, `-h` | Show help for command |
+| `--full` | Show full output without truncation |
+| `--format json` | Output in JSON format |
+
+## Examples
+
+```bash
+lisa status --help
+lisa discover --deep
+lisa feedback mark E1.S2 done
+```