@fro.bot/systematic 2.33.2 → 3.0.0
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.
- package/ATTRIBUTIONS.md +1 -1
- package/agents/design/design-iterator.md +1 -0
- package/agents/research/best-practices-researcher.md +6 -8
- package/agents/review/pattern-recognition-specialist.md +1 -1
- package/agents/workflow/systematic-implementer.md +1 -0
- package/dist/cli.js +348 -53
- package/dist/{index-vyzhzvap.js → index-yskzf7vh.js} +587 -386
- package/dist/index.js +100 -155
- package/dist/lib/agent-overlays.d.ts +0 -1
- package/dist/lib/agent-resolver.d.ts +28 -0
- package/dist/lib/bootstrap.d.ts +8 -1
- package/dist/lib/bundled-names.d.ts +3 -3
- package/dist/lib/pi-delegate-session.d.ts +31 -0
- package/dist/lib/pi-delegate-tool.d.ts +42 -0
- package/dist/lib/removed-names.d.ts +3 -3
- package/dist/lib/setup.d.ts +36 -0
- package/dist/lib/skill-loader.d.ts +1 -2
- package/dist/lib/skill-resolver.d.ts +39 -0
- package/dist/lib/skill-tool.d.ts +2 -11
- package/dist/lib/skills.d.ts +1 -9
- package/dist/lib/source-model-defaults.d.ts +1 -1
- package/dist/pi.d.ts +7 -0
- package/dist/pi.js +3641 -0
- package/dist/schemas/systematic-config.schema.json +47 -242
- package/package.json +31 -8
- package/skills/ce-brainstorm/references/handoff.md +5 -26
- package/skills/ce-brainstorm/references/universal-brainstorming.md +0 -1
- package/skills/ce-compound/SKILL.md +8 -12
- package/skills/ce-ideate/references/post-ideation-workflow.md +21 -85
- package/skills/ce-plan/SKILL.md +6 -6
- package/skills/ce-plan/references/deepening-workflow.md +6 -7
- package/skills/ce-plan/references/plan-handoff.md +1 -17
- package/skills/ce-plan/references/universal-planning.md +0 -4
- package/skills/ce-review/SKILL.md +10 -19
- package/skills/ce-review/references/persona-catalog.md +2 -7
- package/skills/ce-review/references/review-output-template.md +0 -1
- package/skills/ce-work/SKILL.md +1 -1
- package/skills/deepen-plan/SKILL.md +6 -7
- package/skills/document-review/SKILL.md +2 -2
- package/skills/git-commit-push-pr/SKILL.md +1 -2
- package/skills/lfg/SKILL.md +1 -1
- package/skills/onboarding/SKILL.md +1 -12
- package/skills/orchestrating-subagents/SKILL.md +2 -2
- package/skills/slfg/SKILL.md +2 -3
- package/skills/test-browser/SKILL.md +2 -2
- package/skills/todos/SKILL.md +239 -0
- package/skills/writing-skills/SKILL.md +102 -1
- package/skills/{writing-systematic-skills → writing-skills}/references/foundation-conventions.md +5 -5
- package/agents/design/design-implementation-reviewer.md +0 -95
- package/agents/design/figma-design-sync.md +0 -173
- package/agents/docs/ankane-readme-writer.md +0 -51
- package/agents/review/cli-agent-readiness-reviewer.md +0 -418
- package/agents/review/data-integrity-guardian.md +0 -72
- package/agents/review/data-migration-expert.md +0 -99
- package/agents/review/dhh-rails-reviewer.md +0 -46
- package/agents/review/julik-frontend-races-reviewer.md +0 -49
- package/agents/review/kieran-python-reviewer.md +0 -47
- package/agents/review/kieran-rails-reviewer.md +0 -47
- package/agents/review/performance-oracle.md +0 -112
- package/agents/review/schema-drift-detector.md +0 -143
- package/agents/review/security-sentinel.md +0 -95
- package/agents/workflow/lint.md +0 -17
- package/dist/lib/converter.d.ts +0 -14
- package/skills/andrew-kane-gem-writer/SKILL.md +0 -184
- package/skills/andrew-kane-gem-writer/references/database-adapters.md +0 -231
- package/skills/andrew-kane-gem-writer/references/module-organization.md +0 -121
- package/skills/andrew-kane-gem-writer/references/rails-integration.md +0 -183
- package/skills/andrew-kane-gem-writer/references/resources.md +0 -119
- package/skills/andrew-kane-gem-writer/references/testing-patterns.md +0 -261
- package/skills/changelog/SKILL.md +0 -139
- package/skills/claude-permissions-optimizer/SKILL.md +0 -166
- package/skills/claude-permissions-optimizer/scripts/extract-commands.mjs +0 -655
- package/skills/claude-permissions-optimizer/scripts/normalize.mjs +0 -151
- package/skills/dhh-rails-style/SKILL.md +0 -186
- package/skills/dhh-rails-style/references/architecture.md +0 -653
- package/skills/dhh-rails-style/references/controllers.md +0 -303
- package/skills/dhh-rails-style/references/frontend.md +0 -510
- package/skills/dhh-rails-style/references/gems.md +0 -266
- package/skills/dhh-rails-style/references/models.md +0 -359
- package/skills/dhh-rails-style/references/testing.md +0 -338
- package/skills/dspy-ruby/SKILL.md +0 -737
- package/skills/dspy-ruby/assets/config-template.rb +0 -187
- package/skills/dspy-ruby/assets/module-template.rb +0 -300
- package/skills/dspy-ruby/assets/signature-template.rb +0 -221
- package/skills/dspy-ruby/references/core-concepts.md +0 -674
- package/skills/dspy-ruby/references/observability.md +0 -366
- package/skills/dspy-ruby/references/optimization.md +0 -603
- package/skills/dspy-ruby/references/providers.md +0 -418
- package/skills/dspy-ruby/references/toolsets.md +0 -502
- package/skills/every-style-editor/SKILL.md +0 -135
- package/skills/every-style-editor/references/EVERY_WRITE_STYLE.md +0 -529
- package/skills/feature-video/SKILL.md +0 -383
- package/skills/gemini-imagegen/SKILL.md +0 -237
- package/skills/gemini-imagegen/requirements.txt +0 -2
- package/skills/gemini-imagegen/scripts/compose_images.py +0 -157
- package/skills/gemini-imagegen/scripts/edit_image.py +0 -144
- package/skills/gemini-imagegen/scripts/gemini_images.py +0 -263
- package/skills/gemini-imagegen/scripts/generate_image.py +0 -133
- package/skills/gemini-imagegen/scripts/multi_turn_chat.py +0 -216
- package/skills/generate_command/SKILL.md +0 -164
- package/skills/orchestrating-swarms/SKILL.md +0 -1723
- package/skills/proof/SKILL.md +0 -291
- package/skills/proof/references/hitl-review.md +0 -368
- package/skills/rclone/SKILL.md +0 -150
- package/skills/rclone/scripts/check_setup.sh +0 -60
- package/skills/setup/SKILL.md +0 -22
- package/skills/test-xcode/SKILL.md +0 -214
- package/skills/todo-create/SKILL.md +0 -109
- package/skills/todo-resolve/SKILL.md +0 -68
- package/skills/todo-triage/SKILL.md +0 -70
- package/skills/writing-systematic-skills/SKILL.md +0 -119
- /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
|
-
|