@codyswann/lisa 1.66.3 → 1.67.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (30) hide show
  1. package/all/copy-overwrite/.claude/rules/base-rules.md +137 -0
  2. package/nestjs/package-lisa/package.lisa.json +1 -1
  3. package/package.json +1 -1
  4. package/plugins/lisa/.claude-plugin/plugin.json +1 -10
  5. package/plugins/lisa/agents/verification-specialist.md +1 -1
  6. package/plugins/lisa-cdk/.claude-plugin/plugin.json +1 -1
  7. package/plugins/lisa-expo/.claude-plugin/plugin.json +2 -14
  8. package/plugins/lisa-nestjs/.claude-plugin/plugin.json +1 -1
  9. package/plugins/lisa-rails/.claude-plugin/plugin.json +1 -12
  10. package/plugins/lisa-typescript/.claude-plugin/plugin.json +1 -12
  11. package/plugins/src/base/.claude-plugin/plugin.json +0 -9
  12. package/plugins/src/base/agents/verification-specialist.md +1 -1
  13. package/plugins/src/expo/.claude-plugin/plugin.json +2 -13
  14. package/plugins/src/rails/.claude-plugin/plugin.json +0 -11
  15. package/plugins/src/typescript/.claude-plugin/plugin.json +0 -11
  16. package/typescript/package-lisa/package.lisa.json +2 -2
  17. package/plugins/lisa/rules/README.md +0 -240
  18. package/plugins/lisa-rails/rules/lisa.md +0 -42
  19. package/plugins/lisa-typescript/rules/lisa.md +0 -37
  20. package/plugins/src/base/rules/README.md +0 -240
  21. package/plugins/src/base/rules/coding-philosophy.md +0 -428
  22. package/plugins/src/base/rules/verfication.md +0 -594
  23. package/plugins/src/expo/rules/expo-verification.md +0 -261
  24. package/plugins/src/rails/rules/lisa.md +0 -42
  25. package/plugins/src/rails/rules/rails-conventions.md +0 -176
  26. package/plugins/src/typescript/rules/lisa.md +0 -37
  27. /package/{plugins/lisa → all/copy-overwrite/.claude}/rules/coding-philosophy.md +0 -0
  28. /package/{plugins/lisa/rules/verfication.md → all/copy-overwrite/.claude/rules/verification.md} +0 -0
  29. /package/{plugins/lisa-expo → expo/copy-overwrite/.claude}/rules/expo-verification.md +0 -0
  30. /package/{plugins/lisa-rails → rails/copy-overwrite/.claude}/rules/rails-conventions.md +0 -0
@@ -1,42 +0,0 @@
1
- # Lisa-Managed Files
2
-
3
- The following files are managed by Lisa and will be overwritten on every `lisa` run. Never edit them directly. Where a local override exists, edit that instead.
4
-
5
- ## Files with local overrides (edit the override, not the managed file)
6
-
7
- | Managed File (do not edit) | Local Override (edit this instead) |
8
- |---|---|
9
- | `.rubocop.yml` | `.rubocop.local.yml` |
10
-
11
- ## Create-only files (edit freely, Lisa won't overwrite)
12
-
13
- - `.claude/rules/PROJECT_RULES.md`
14
- - `.rubocop.local.yml`
15
- - `.simplecov`
16
- - `.reek.yml`
17
- - `.rspec`
18
- - `simplecov.thresholds.json`
19
- - `rubocop.thresholds.yml`
20
- - `sonar-project.properties`
21
- - `spec/spec_helper.rb`
22
- - `spec/rails_helper.rb`
23
- - `.github/workflows/ci.yml`
24
- - `.github/workflows/claude-nightly-test-coverage.yml`
25
- - `.github/workflows/claude-nightly-code-complexity.yml`
26
- - `.github/workflows/claude-nightly-test-improvement.yml`
27
- - `VERSION`
28
-
29
- ## Deep-merged by Lisa (Lisa wins conflicts, but project can add its own keys)
30
-
31
- - `.claude/settings.json`
32
-
33
- ## Plugin-managed content (agents, skills, hooks, commands, rules)
34
-
35
- These resources are distributed via the stack Claude Code plugin (`rails@lisa`). Rules — including this file — are injected into each prompt automatically. Do not add these files to your project directory.
36
-
37
- ## Copy-overwrite files (do not edit — full list)
38
-
39
- - `.safety-net.json`
40
- - `.rubocop.yml`, `.versionrc`, `lefthook.yml`, `Gemfile.lisa`
41
- - `config/initializers/version.rb`
42
- - `.coderabbit.yml`, `commitlint.config.cjs`
@@ -1,37 +0,0 @@
1
- # Lisa-Managed Files
2
-
3
- The following files are managed by Lisa and will be overwritten on every `lisa` run. Never edit them directly. Where a local override exists, edit that instead.
4
-
5
- ## Files with local overrides (edit the override, not the managed file)
6
-
7
- | Managed File (do not edit) | Local Override (edit this instead) |
8
- |---|---|
9
- | `eslint.config.ts` | `eslint.config.local.ts` |
10
- | `vitest.config.ts` | `vitest.config.local.ts` |
11
- | `tsconfig.json` | `tsconfig.local.json` |
12
-
13
- ## Create-only files (edit freely, Lisa won't overwrite)
14
-
15
- - `.claude/rules/PROJECT_RULES.md`
16
- - `eslint.thresholds.json`
17
- - `vitest.thresholds.json`
18
-
19
- ## Deep-merged by Lisa (Lisa wins conflicts, but project can add its own keys)
20
-
21
- - `.claude/settings.json`
22
-
23
- ## Plugin-managed content (agents, skills, hooks, commands, rules)
24
-
25
- These resources are distributed via the stack Claude Code plugin (e.g., `typescript@lisa`). Rules — including this file — are injected into each prompt automatically. Do not add these files to your project directory.
26
-
27
- ## Copy-overwrite files (do not edit — full list)
28
-
29
- - `.prettierrc.json`, `.prettierignore`, `.lintstagedrc.json`, `.versionrc`, `.nvmrc`
30
- - `.yamllint`, `.gitleaksignore`, `.coderabbit.yml`, `commitlint.config.cjs`, `sgconfig.yml`, `knip.json`
31
- - `.safety-net.json`, `audit.ignore.config.json`
32
- - `eslint.base.ts`, `eslint.typescript.ts` (+ `expo`/`nestjs`/`cdk` variants), `eslint.slow.config.ts`
33
- - `vitest.config.ts`
34
- - `tsconfig.base.json`, `tsconfig.typescript.json` (+ variants), `tsconfig.eslint.json`, `tsconfig.build.json`, `tsconfig.spec.json`
35
- - `.github/workflows/quality.yml`, `release.yml`, `claude.yml`, and all other Claude/CI workflows
36
- - `.github/dependabot.yml`, `.github/GITHUB_ACTIONS.md`
37
- - `ast-grep/rules/`, `ast-grep/utils/`, `ast-grep/rule-tests/`
@@ -1,240 +0,0 @@
1
- # Claude Code Configuration
2
-
3
- This directory contains Claude Code configuration files that customize AI-assisted development workflows.
4
-
5
- ## Directory Structure
6
-
7
- ```
8
- .claude/
9
- ├── settings.json # Main Claude Code settings
10
- ├── settings.local.json # Local overrides (gitignored)
11
- ├── settings.local.json.example # Template for local settings
12
- ├── agents/ # Custom agent definitions
13
- ├── hooks/ # Automation hooks
14
- ├── rules/ # Always-on governance rules
15
- └── skills/ # Skill definitions (colon-namespaced)
16
- ```
17
-
18
- ## Settings
19
-
20
- ### Environment Variables
21
-
22
- | Variable | Default | Description |
23
- |----------|---------|-------------|
24
- | `BASH_DEFAULT_TIMEOUT_MS` | 1800000 (30 min) | Default timeout for bash commands |
25
- | `BASH_MAX_TIMEOUT_MS` | 7200000 (2 hours) | Maximum allowed timeout |
26
-
27
- ### Hooks
28
-
29
- | Event | Hook | Purpose |
30
- |-------|------|---------|
31
- | `SessionStart` | `install-pkgs.sh` | Install dependencies when session starts |
32
- | `PostToolUse` | `format-on-edit.sh` | Auto-format files after Write/Edit operations |
33
- | `Notification` | `notify-ntfy.sh` | Send notifications via ntfy.sh |
34
- | `Stop` | `notify-ntfy.sh` | Notify when session ends |
35
-
36
- ## Plugins
37
-
38
- The `enabledPlugins` section in `settings.json` references Claude Code plugins. These extend Claude Code functionality with additional capabilities.
39
-
40
- ### Plugin Sources
41
-
42
- | Source | Description | Registration |
43
- |--------|-------------|--------------|
44
- | `claude-plugins-official` | Official Anthropic plugins | Built-in, no registration needed |
45
- | `cc-marketplace` | Community marketplace | Available at [Claude Code Marketplace](https://marketplace.claude.ai) |
46
-
47
- ### Enabled Plugins
48
-
49
- | Plugin | Source | Purpose |
50
- |--------|--------|---------|
51
- | `typescript-lsp` | `claude-plugins-official` | TypeScript language server integration |
52
- | `safety-net` | `cc-marketplace` | Backup and safety features |
53
- | `code-simplifier` | `claude-plugins-official` | Code complexity reduction suggestions |
54
- | `code-review` | `claude-plugins-official` | Automated code review capabilities |
55
- | `playwright` | `claude-plugins-official` | Playwright test integration |
56
-
57
- ### Installing Plugins
58
-
59
- 1. **Official plugins** are available by default in Claude Code
60
- 2. **Marketplace plugins** can be installed via the Claude Code settings UI
61
- 3. **Third-party plugins** require following their installation instructions
62
-
63
- ### Plugin Availability
64
-
65
- Not all plugins may be available in all Claude Code installations:
66
-
67
- - Some plugins require specific Claude Code versions
68
- - Marketplace plugins require marketplace access
69
- - Enterprise installations may restrict available plugins
70
-
71
- If a plugin is not available, Claude Code will ignore it gracefully.
72
-
73
- ## Local Settings Override
74
-
75
- Create `settings.local.json` to override settings for your local environment:
76
-
77
- ```json
78
- {
79
- "env": {
80
- "CUSTOM_API_KEY": "your-key-here"
81
- },
82
- "hooks": {
83
- "PostToolUse": []
84
- },
85
- "enabledPlugins": {
86
- "playwright": false
87
- }
88
- }
89
- ```
90
-
91
- This file should be:
92
- - Added to `.gitignore`
93
- - Never committed to version control
94
- - Used for machine-specific settings
95
-
96
- ## Agents
97
-
98
- Custom agent definitions in `agents/` provide specialized AI personas for different tasks:
99
-
100
- | Agent | Purpose |
101
- |-------|---------|
102
- | `agent-architect.md` | Agent file design and optimization |
103
- | `architecture-specialist.md` | Implementation design, dependency mapping, pattern evaluation |
104
- | `git-history-analyzer.md` | Git history analysis |
105
- | `hooks-expert.md` | Claude Code hooks expertise |
106
- | `implementer.md` | Code implementation with TDD enforcement |
107
- | `learner.md` | Post-implementation learning and skill creation |
108
- | `performance-specialist.md` | N+1 queries, algorithmic complexity, memory leaks |
109
- | `product-specialist.md` | User flows, acceptance criteria, UX validation |
110
- | `quality-specialist.md` | Code correctness, coding philosophy, test coverage review |
111
- | `security-specialist.md` | Threat modeling (STRIDE), OWASP Top 10, auth/secrets review |
112
- | `skill-evaluator.md` | Skill quality assessment |
113
- | `slash-command-architect.md` | Command design |
114
- | `test-specialist.md` | Test strategy, test writing, coverage analysis |
115
- | `web-search-researcher.md` | Web research tasks |
116
-
117
- ## Skills
118
-
119
- Skills use colon-namespaced directories (e.g., `plan:create/`) and are invoked via `/skill-name` in Claude Code.
120
-
121
- ### Plan Skills
122
-
123
- | Skill | Purpose |
124
- |-------|---------|
125
- | `plan:create` | Create implementation plans from ticket URLs, file paths, or text descriptions |
126
- | `plan:implement` | Execute an existing plan with an Agent Team |
127
- | `plan:add-test-coverage` | Increase test coverage to a target threshold |
128
- | `plan:fix-linter-error` | Fix all violations of specific ESLint rules |
129
- | `plan:local-code-review` | Review local branch changes against main |
130
- | `plan:lower-code-complexity` | Reduce cognitive complexity threshold |
131
- | `plan:reduce-max-lines` | Reduce max file lines threshold |
132
- | `plan:reduce-max-lines-per-function` | Reduce max function lines threshold |
133
-
134
- ### Git Skills
135
-
136
- | Skill | Purpose |
137
- |-------|---------|
138
- | `git:commit` | Create conventional commits for current changes |
139
- | `git:commit-and-submit-pr` | Commit changes and create/update a pull request |
140
- | `git:submit-pr` | Push changes and create or update a pull request |
141
- | `git:prune` | Prune local branches deleted on remote |
142
-
143
- ### Integration Skills
144
-
145
- | Skill | Purpose |
146
- |-------|---------|
147
- | `jira:create` | Create JIRA epics, stories, and tasks |
148
- | `jira:verify` | Verify JIRA ticket meets organizational standards |
149
- | `jira:sync` | Sync plan progress to linked JIRA tickets |
150
- | `sonarqube:check` | Check SonarQube/SonarCloud quality gate failures |
151
- | `sonarqube:fix` | Fix SonarQube quality gate failures |
152
- | `pull-request:review` | Check and implement PR review comments |
153
- | `security:zap-scan` | Run OWASP ZAP baseline security scan |
154
-
155
- ### Utility Skills
156
-
157
- | Skill | Purpose |
158
- |-------|---------|
159
- | `tasks:load` | Load tasks from project directory into session |
160
- | `tasks:sync` | Export session tasks to project directory |
161
- | `skill-creator` | Guide for creating new skills |
162
- | `agent-design-best-practices` | Best practices for designing agent files |
163
- | `jsdoc-best-practices` | JSDoc documentation standards |
164
-
165
- See each skill's `SKILL.md` for detailed documentation.
166
-
167
- ## Customization
168
-
169
- ### Adding Custom Skills
170
-
171
- Skills contain implementation logic and use hyphen-separated naming:
172
-
173
- ```bash
174
- mkdir -p .claude/skills/my-namespace-my-skill
175
- cat > .claude/skills/my-namespace-my-skill/SKILL.md << 'EOF'
176
- ---
177
- name: my-namespace-my-skill
178
- description: "What this skill does"
179
- ---
180
-
181
- # My Skill
182
-
183
- Instructions for the skill...
184
- EOF
185
- ```
186
-
187
- ### Adding Custom Commands
188
-
189
- Commands are user-facing pass-throughs to skills. Directory nesting creates colon-separated names in the UI (e.g., `my-namespace/my-skill.md` becomes `/my-namespace:my-skill`):
190
-
191
- ```bash
192
- mkdir -p .claude/commands/my-namespace
193
- cat > .claude/commands/my-namespace/my-skill.md << 'EOF'
194
- ---
195
- description: "What this command does"
196
- allowed-tools: ["Skill"]
197
- argument-hint: "<arguments>"
198
- ---
199
-
200
- Use the /my-namespace-my-skill skill to do the thing. $ARGUMENTS
201
- EOF
202
- ```
203
-
204
- ### Adding Custom Agents
205
-
206
- ```bash
207
- cat > .claude/agents/my-agent.md << 'EOF'
208
- # My Agent
209
-
210
- ## Role
211
- Specialized for specific tasks...
212
-
213
- ## Capabilities
214
- - Capability 1
215
- - Capability 2
216
-
217
- ## Instructions
218
- How to behave...
219
- EOF
220
- ```
221
-
222
- ## Troubleshooting
223
-
224
- ### Hooks Not Running
225
-
226
- 1. Check file permissions: `chmod +x .claude/hooks/*.sh`
227
- 2. Verify `$CLAUDE_PROJECT_DIR` is set correctly
228
- 3. Check hook timeout settings
229
-
230
- ### Plugins Not Loading
231
-
232
- 1. Verify plugin is installed in your Claude Code installation
233
- 2. Check marketplace access if using marketplace plugins
234
- 3. Review Claude Code logs for plugin errors
235
-
236
- ### Skills Not Found
237
-
238
- 1. Ensure skill directory contains a `SKILL.md` file with correct frontmatter
239
- 2. Restart Claude Code to reload skills
240
- 3. Check for syntax errors in skill definition