@fro.bot/systematic 2.33.3 → 3.0.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 (112) hide show
  1. package/ATTRIBUTIONS.md +1 -1
  2. package/agents/design/design-iterator.md +1 -0
  3. package/agents/research/best-practices-researcher.md +6 -8
  4. package/agents/review/pattern-recognition-specialist.md +1 -1
  5. package/agents/workflow/systematic-implementer.md +1 -0
  6. package/dist/cli.js +348 -53
  7. package/dist/{index-vyzhzvap.js → index-yskzf7vh.js} +587 -386
  8. package/dist/index.js +100 -155
  9. package/dist/lib/agent-overlays.d.ts +0 -1
  10. package/dist/lib/agent-resolver.d.ts +28 -0
  11. package/dist/lib/bootstrap.d.ts +8 -1
  12. package/dist/lib/bundled-names.d.ts +3 -3
  13. package/dist/lib/pi-delegate-session.d.ts +31 -0
  14. package/dist/lib/pi-delegate-tool.d.ts +42 -0
  15. package/dist/lib/removed-names.d.ts +3 -3
  16. package/dist/lib/setup.d.ts +36 -0
  17. package/dist/lib/skill-loader.d.ts +1 -2
  18. package/dist/lib/skill-resolver.d.ts +39 -0
  19. package/dist/lib/skill-tool.d.ts +2 -11
  20. package/dist/lib/skills.d.ts +1 -9
  21. package/dist/lib/source-model-defaults.d.ts +1 -1
  22. package/dist/pi.d.ts +7 -0
  23. package/dist/pi.js +3641 -0
  24. package/dist/schemas/systematic-config.schema.json +47 -242
  25. package/package.json +29 -6
  26. package/skills/ce-brainstorm/references/handoff.md +5 -26
  27. package/skills/ce-brainstorm/references/universal-brainstorming.md +0 -1
  28. package/skills/ce-compound/SKILL.md +8 -12
  29. package/skills/ce-ideate/references/post-ideation-workflow.md +21 -85
  30. package/skills/ce-plan/SKILL.md +6 -6
  31. package/skills/ce-plan/references/deepening-workflow.md +6 -7
  32. package/skills/ce-plan/references/plan-handoff.md +1 -17
  33. package/skills/ce-plan/references/universal-planning.md +0 -4
  34. package/skills/ce-review/SKILL.md +10 -19
  35. package/skills/ce-review/references/persona-catalog.md +2 -7
  36. package/skills/ce-review/references/review-output-template.md +0 -1
  37. package/skills/ce-work/SKILL.md +1 -1
  38. package/skills/deepen-plan/SKILL.md +6 -7
  39. package/skills/document-review/SKILL.md +2 -2
  40. package/skills/git-commit-push-pr/SKILL.md +1 -2
  41. package/skills/lfg/SKILL.md +1 -1
  42. package/skills/onboarding/SKILL.md +1 -12
  43. package/skills/orchestrating-subagents/SKILL.md +2 -2
  44. package/skills/slfg/SKILL.md +2 -3
  45. package/skills/test-browser/SKILL.md +2 -2
  46. package/skills/todos/SKILL.md +239 -0
  47. package/skills/writing-skills/SKILL.md +102 -1
  48. package/skills/{writing-systematic-skills → writing-skills}/references/foundation-conventions.md +5 -5
  49. package/agents/design/design-implementation-reviewer.md +0 -95
  50. package/agents/design/figma-design-sync.md +0 -173
  51. package/agents/docs/ankane-readme-writer.md +0 -51
  52. package/agents/review/cli-agent-readiness-reviewer.md +0 -418
  53. package/agents/review/data-integrity-guardian.md +0 -72
  54. package/agents/review/data-migration-expert.md +0 -99
  55. package/agents/review/dhh-rails-reviewer.md +0 -46
  56. package/agents/review/julik-frontend-races-reviewer.md +0 -49
  57. package/agents/review/kieran-python-reviewer.md +0 -47
  58. package/agents/review/kieran-rails-reviewer.md +0 -47
  59. package/agents/review/performance-oracle.md +0 -112
  60. package/agents/review/schema-drift-detector.md +0 -143
  61. package/agents/review/security-sentinel.md +0 -95
  62. package/agents/workflow/lint.md +0 -17
  63. package/dist/lib/converter.d.ts +0 -14
  64. package/skills/andrew-kane-gem-writer/SKILL.md +0 -184
  65. package/skills/andrew-kane-gem-writer/references/database-adapters.md +0 -231
  66. package/skills/andrew-kane-gem-writer/references/module-organization.md +0 -121
  67. package/skills/andrew-kane-gem-writer/references/rails-integration.md +0 -183
  68. package/skills/andrew-kane-gem-writer/references/resources.md +0 -119
  69. package/skills/andrew-kane-gem-writer/references/testing-patterns.md +0 -261
  70. package/skills/changelog/SKILL.md +0 -139
  71. package/skills/claude-permissions-optimizer/SKILL.md +0 -166
  72. package/skills/claude-permissions-optimizer/scripts/extract-commands.mjs +0 -655
  73. package/skills/claude-permissions-optimizer/scripts/normalize.mjs +0 -151
  74. package/skills/dhh-rails-style/SKILL.md +0 -186
  75. package/skills/dhh-rails-style/references/architecture.md +0 -653
  76. package/skills/dhh-rails-style/references/controllers.md +0 -303
  77. package/skills/dhh-rails-style/references/frontend.md +0 -510
  78. package/skills/dhh-rails-style/references/gems.md +0 -266
  79. package/skills/dhh-rails-style/references/models.md +0 -359
  80. package/skills/dhh-rails-style/references/testing.md +0 -338
  81. package/skills/dspy-ruby/SKILL.md +0 -737
  82. package/skills/dspy-ruby/assets/config-template.rb +0 -187
  83. package/skills/dspy-ruby/assets/module-template.rb +0 -300
  84. package/skills/dspy-ruby/assets/signature-template.rb +0 -221
  85. package/skills/dspy-ruby/references/core-concepts.md +0 -674
  86. package/skills/dspy-ruby/references/observability.md +0 -366
  87. package/skills/dspy-ruby/references/optimization.md +0 -603
  88. package/skills/dspy-ruby/references/providers.md +0 -418
  89. package/skills/dspy-ruby/references/toolsets.md +0 -502
  90. package/skills/every-style-editor/SKILL.md +0 -135
  91. package/skills/every-style-editor/references/EVERY_WRITE_STYLE.md +0 -529
  92. package/skills/feature-video/SKILL.md +0 -383
  93. package/skills/gemini-imagegen/SKILL.md +0 -237
  94. package/skills/gemini-imagegen/requirements.txt +0 -2
  95. package/skills/gemini-imagegen/scripts/compose_images.py +0 -157
  96. package/skills/gemini-imagegen/scripts/edit_image.py +0 -144
  97. package/skills/gemini-imagegen/scripts/gemini_images.py +0 -263
  98. package/skills/gemini-imagegen/scripts/generate_image.py +0 -133
  99. package/skills/gemini-imagegen/scripts/multi_turn_chat.py +0 -216
  100. package/skills/generate_command/SKILL.md +0 -164
  101. package/skills/orchestrating-swarms/SKILL.md +0 -1723
  102. package/skills/proof/SKILL.md +0 -291
  103. package/skills/proof/references/hitl-review.md +0 -368
  104. package/skills/rclone/SKILL.md +0 -150
  105. package/skills/rclone/scripts/check_setup.sh +0 -60
  106. package/skills/setup/SKILL.md +0 -22
  107. package/skills/test-xcode/SKILL.md +0 -214
  108. package/skills/todo-create/SKILL.md +0 -109
  109. package/skills/todo-resolve/SKILL.md +0 -68
  110. package/skills/todo-triage/SKILL.md +0 -70
  111. package/skills/writing-systematic-skills/SKILL.md +0 -119
  112. /package/skills/{todo-create → todos}/assets/todo-template.md +0 -0
@@ -1,151 +0,0 @@
1
- // Normalization helpers extracted from extract-commands.mjs for testability.
2
-
3
- // Risk-modifying flags that must NOT be collapsed into wildcards.
4
- // Global flags are always preserved; context-specific flags only matter
5
- // for certain base commands.
6
- const GLOBAL_RISK_FLAGS = new Set([
7
- '--force',
8
- '--hard',
9
- '-rf',
10
- '--privileged',
11
- '--no-verify',
12
- '--system',
13
- '--force-with-lease',
14
- '-D',
15
- '--force-if-includes',
16
- '--volumes',
17
- '--rmi',
18
- '--rewrite',
19
- '--delete',
20
- ])
21
-
22
- // Flags that are only risky for specific base commands.
23
- // -f means force-push in git, force-remove in docker, but pattern-file in grep.
24
- // -v means remove-volumes in docker-compose, but verbose everywhere else.
25
- const CONTEXTUAL_RISK_FLAGS = {
26
- '-f': new Set(['git', 'docker', 'rm']),
27
- '-v': new Set(['docker', 'docker-compose']),
28
- }
29
-
30
- export function isRiskFlag(token, base) {
31
- if (GLOBAL_RISK_FLAGS.has(token)) return true
32
- // Check context-specific flags
33
- const contexts = Object.hasOwn(CONTEXTUAL_RISK_FLAGS, token)
34
- ? CONTEXTUAL_RISK_FLAGS[token]
35
- : undefined
36
- if (contexts && base && contexts.has(base)) return true
37
- // Combined short flags containing risk chars: -rf, -fr, -fR, etc.
38
- if (/^-[a-zA-Z]*[rf][a-zA-Z]*$/.test(token) && token.length <= 4) return true
39
- return false
40
- }
41
-
42
- export function normalize(command) {
43
- // Don't normalize shell injection patterns
44
- if (/\|\s*(sh|bash|zsh)\b/.test(command)) return command
45
- // Don't normalize sudo -- keep as-is
46
- if (/^sudo\s/.test(command)) return 'sudo *'
47
-
48
- // Handle pnpm --filter <pkg> <subcommand> specially
49
- const pnpmFilter = command.match(/^pnpm\s+--filter\s+\S+\s+(\S+)/)
50
- if (pnpmFilter) return `pnpm --filter * ${pnpmFilter[1]} *`
51
-
52
- // Handle sed specially -- preserve the mode flag to keep safe patterns narrow.
53
- // sed -i (in-place) is destructive; sed -n, sed -e, bare sed are read-only.
54
- if (/^sed\s/.test(command)) {
55
- if (/\s-i\b/.test(command)) return 'sed -i *'
56
- const sedFlag = command.match(/^sed\s+(-[a-zA-Z])\s/)
57
- return sedFlag ? `sed ${sedFlag[1]} *` : 'sed *'
58
- }
59
-
60
- // Handle ast-grep specially -- preserve --rewrite flag.
61
- if (/^(ast-grep|sg)\s/.test(command)) {
62
- const base = command.startsWith('sg') ? 'sg' : 'ast-grep'
63
- return /\s--rewrite\b/.test(command) ? `${base} --rewrite *` : `${base} *`
64
- }
65
-
66
- // Handle find specially -- preserve key action flags.
67
- // find -delete and find -exec rm are destructive; find -name/-type are safe.
68
- if (/^find\s/.test(command)) {
69
- if (/\s-delete\b/.test(command)) return 'find -delete *'
70
- if (/\s-exec\s/.test(command)) return 'find -exec *'
71
- // Extract the first predicate flag for a narrower safe pattern
72
- const findFlag = command.match(/\s(-(?:name|type|path|iname))\s/)
73
- return findFlag ? `find ${findFlag[1]} *` : 'find *'
74
- }
75
-
76
- // Handle git -C <dir> <subcommand> -- strip the -C <dir> and normalize the git subcommand
77
- const gitC = command.match(/^git\s+-C\s+\S+\s+(.+)$/)
78
- if (gitC) return normalize(`git ${gitC[1]}`)
79
-
80
- // Split on compound operators -- normalize the first command only
81
- const compoundMatch = command.match(/^(.+?)\s*(&&|\|\||;)\s*(.+)$/)
82
- if (compoundMatch) {
83
- return normalize(compoundMatch[1].trim())
84
- }
85
-
86
- // Strip trailing pipe chains for normalization (e.g., `cmd | tail -5`)
87
- // but preserve pipe-to-shell (already handled by shell injection check above)
88
- const pipeMatch = command.match(/^(.+?)\s*\|\s*(.+)$/)
89
- if (pipeMatch) {
90
- return normalize(pipeMatch[1].trim())
91
- }
92
-
93
- // Strip trailing redirections (2>&1, > file, >> file)
94
- const cleaned = command
95
- .replace(/\s*[12]?>>?\s*\S+\s*$/, '')
96
- .replace(/\s*2>&1\s*$/, '')
97
- .trim()
98
-
99
- const parts = cleaned.split(/\s+/)
100
- if (parts.length === 0) return command
101
-
102
- const base = parts[0]
103
-
104
- // For git/docker/gh/npm etc, include the subcommand
105
- const multiWordBases = [
106
- 'git',
107
- 'docker',
108
- 'docker-compose',
109
- 'gh',
110
- 'npm',
111
- 'bun',
112
- 'pnpm',
113
- 'yarn',
114
- 'cargo',
115
- 'pip',
116
- 'pip3',
117
- 'bundle',
118
- 'systemctl',
119
- 'kubectl',
120
- ]
121
-
122
- let prefix = base
123
- let argStart = 1
124
-
125
- if (multiWordBases.includes(base) && parts.length > 1) {
126
- prefix = `${base} ${parts[1]}`
127
- argStart = 2
128
- }
129
-
130
- // Preserve risk-modifying flags in the remaining args
131
- const preservedFlags = []
132
- for (let i = argStart; i < parts.length; i++) {
133
- if (isRiskFlag(parts[i], base)) {
134
- preservedFlags.push(parts[i])
135
- }
136
- }
137
-
138
- // Build the normalized pattern
139
- if (parts.length <= argStart && preservedFlags.length === 0) {
140
- return prefix // no args, no flags: e.g., "git status"
141
- }
142
-
143
- const flagStr =
144
- preservedFlags.length > 0 ? ` ${preservedFlags.join(' ')}` : ''
145
- const hasVaryingArgs = parts.length > argStart + preservedFlags.length
146
-
147
- if (hasVaryingArgs) {
148
- return `${prefix + flagStr} *`
149
- }
150
- return prefix + flagStr
151
- }
@@ -1,186 +0,0 @@
1
- ---
2
- name: dhh-rails-style
3
- description: This skill should be used when writing Ruby and Rails code in DHH's distinctive 37signals style. It applies when writing Ruby code, Rails applications, creating models, controllers, or any Ruby file. Triggers on Ruby/Rails code generation, refactoring requests, code review, or when the user mentions DHH, 37signals, Basecamp, HEY, or Campfire style. Embodies REST purity, fat models, thin controllers, Current attributes, Hotwire patterns, and the "clarity over cleverness" philosophy.
4
- ---
5
-
6
- <objective>
7
- Apply 37signals/DHH Rails conventions to Ruby and Rails code. This skill provides comprehensive domain expertise extracted from analyzing production 37signals codebases (Fizzy/Campfire) and DHH's code review patterns.
8
- </objective>
9
-
10
- <essential_principles>
11
- ## Core Philosophy
12
-
13
- "The best code is the code you don't write. The second best is the code that's obviously correct."
14
-
15
- **Vanilla Rails is plenty:**
16
- - Rich domain models over service objects
17
- - CRUD controllers over custom actions
18
- - Concerns for horizontal code sharing
19
- - Records as state instead of boolean columns
20
- - Database-backed everything (no Redis)
21
- - Build solutions before reaching for gems
22
-
23
- **What they deliberately avoid:**
24
- - devise (custom ~150-line auth instead)
25
- - pundit/cancancan (simple role checks in models)
26
- - sidekiq (Solid Queue uses database)
27
- - redis (database for everything)
28
- - view_component (partials work fine)
29
- - GraphQL (REST with Turbo sufficient)
30
- - factory_bot (fixtures are simpler)
31
- - rspec (Minitest ships with Rails)
32
- - Tailwind (native CSS with layers)
33
-
34
- **Development Philosophy:**
35
- - Ship, Validate, Refine - prototype-quality code to production to learn
36
- - Fix root causes, not symptoms
37
- - Write-time operations over read-time computations
38
- - Database constraints over ActiveRecord validations
39
- </essential_principles>
40
-
41
- <intake>
42
- What are you working on?
43
-
44
- 1. **Controllers** - REST mapping, concerns, Turbo responses, API patterns
45
- 2. **Models** - Concerns, state records, callbacks, scopes, POROs
46
- 3. **Views & Frontend** - Turbo, Stimulus, CSS, partials
47
- 4. **Architecture** - Routing, multi-tenancy, authentication, jobs, caching
48
- 5. **Testing** - Minitest, fixtures, integration tests
49
- 6. **Gems & Dependencies** - What to use vs avoid
50
- 7. **Code Review** - Review code against DHH style
51
- 8. **General Guidance** - Philosophy and conventions
52
-
53
- **Specify a number or describe your task.**
54
- </intake>
55
-
56
- <routing>
57
-
58
- | Response | Reference to Read |
59
- |----------|-------------------|
60
- | 1, controller | `references/controllers.md` |
61
- | 2, model | `references/models.md` |
62
- | 3, view, frontend, turbo, stimulus, css | `references/frontend.md` |
63
- | 4, architecture, routing, auth, job, cache | `references/architecture.md` |
64
- | 5, test, testing, minitest, fixture | `references/testing.md` |
65
- | 6, gem, dependency, library | `references/gems.md` |
66
- | 7, review | Read all references, then review code |
67
- | 8, general task | Read relevant references based on context |
68
-
69
- **After reading relevant references, apply patterns to the user's code.**
70
- </routing>
71
-
72
- <quick_reference>
73
- ## Naming Conventions
74
-
75
- **Verbs:** `card.close`, `card.gild`, `board.publish` (not `set_style` methods)
76
-
77
- **Predicates:** `card.closed?`, `card.golden?` (derived from presence of related record)
78
-
79
- **Concerns:** Adjectives describing capability (`Closeable`, `Publishable`, `Watchable`)
80
-
81
- **Controllers:** Nouns matching resources (`Cards::ClosuresController`)
82
-
83
- **Scopes:**
84
- - `chronologically`, `reverse_chronologically`, `alphabetically`, `latest`
85
- - `preloaded` (standard eager loading name)
86
- - `indexed_by`, `sorted_by` (parameterized)
87
- - `active`, `unassigned` (business terms, not SQL-ish)
88
-
89
- ## REST Mapping
90
-
91
- Instead of custom actions, create new resources:
92
-
93
- ```
94
- POST /cards/:id/close → POST /cards/:id/closure
95
- DELETE /cards/:id/close → DELETE /cards/:id/closure
96
- POST /cards/:id/archive → POST /cards/:id/archival
97
- ```
98
-
99
- ## Ruby Syntax Preferences
100
-
101
- ```ruby
102
- # Symbol arrays with spaces inside brackets
103
- before_action :set_message, only: %i[ show edit update destroy ]
104
-
105
- # Private method indentation
106
- private
107
- def set_message
108
- @message = Message.find(params[:id])
109
- end
110
-
111
- # Expression-less case for conditionals
112
- case
113
- when params[:before].present?
114
- messages.page_before(params[:before])
115
- else
116
- messages.last_page
117
- end
118
-
119
- # Bang methods for fail-fast
120
- @message = Message.create!(params)
121
-
122
- # Ternaries for simple conditionals
123
- @room.direct? ? @room.users : @message.mentionees
124
- ```
125
-
126
- ## Key Patterns
127
-
128
- **State as Records:**
129
- ```ruby
130
- Card.joins(:closure) # closed cards
131
- Card.where.missing(:closure) # open cards
132
- ```
133
-
134
- **Current Attributes:**
135
- ```ruby
136
- belongs_to :creator, default: -> { Current.user }
137
- ```
138
-
139
- **Authorization on Models:**
140
- ```ruby
141
- class User < ApplicationRecord
142
- def can_administer?(message)
143
- message.creator == self || admin?
144
- end
145
- end
146
- ```
147
- </quick_reference>
148
-
149
- <reference_index>
150
- ## Domain Knowledge
151
-
152
- All detailed patterns in `references/`:
153
-
154
- | File | Topics |
155
- |------|--------|
156
- | `references/controllers.md` | REST mapping, concerns, Turbo responses, API patterns, HTTP caching |
157
- | `references/models.md` | Concerns, state records, callbacks, scopes, POROs, authorization, broadcasting |
158
- | `references/frontend.md` | Turbo Streams, Stimulus controllers, CSS layers, OKLCH colors, partials |
159
- | `references/architecture.md` | Routing, authentication, jobs, Current attributes, caching, database patterns |
160
- | `references/testing.md` | Minitest, fixtures, unit/integration/system tests, testing patterns |
161
- | `references/gems.md` | What they use vs avoid, decision framework, Gemfile examples |
162
- </reference_index>
163
-
164
- <success_criteria>
165
- Code follows DHH style when:
166
- - Controllers map to CRUD verbs on resources
167
- - Models use concerns for horizontal behavior
168
- - State is tracked via records, not booleans
169
- - No unnecessary service objects or abstractions
170
- - Database-backed solutions preferred over external services
171
- - Tests use Minitest with fixtures
172
- - Turbo/Stimulus for interactivity (no heavy JS frameworks)
173
- - Native CSS with modern features (layers, OKLCH, nesting)
174
- - Authorization logic lives on User model
175
- - Jobs are shallow wrappers calling model methods
176
- </success_criteria>
177
-
178
- <credits>
179
- Based on [The Unofficial 37signals/DHH Rails Style Guide](https://github.com/marckohlbrugge/unofficial-37signals-coding-style-guide) by [Marc Köhlbrugge](https://x.com/marckohlbrugge), generated through deep analysis of 265 pull requests from the Fizzy codebase.
180
-
181
- **Important Disclaimers:**
182
- - LLM-generated guide - may contain inaccuracies
183
- - Code examples from Fizzy are licensed under the O'Saasy License
184
- - Not affiliated with or endorsed by 37signals
185
- </credits>
186
-