@fro.bot/systematic 3.26.1 → 3.26.3

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.
@@ -25,7 +25,7 @@ Return: List the changed files and summarize the implementation.
25
25
  - **Specialist** — the registered agent or persona best suited to the work (for example, an implementer or researcher)
26
26
  - **Objective** — a concise statement of the outcome
27
27
  - **Scope** — full instructions, boundaries, dependencies, and files in scope
28
- - **Workspace** — for any write-capable dispatch, the explicit expected repository or worktree root
28
+ - **Workspace** — for any write-capable dispatch, the explicit expected repository or worktree root. To create a worktree for the work, use the `git-worktree` skill, which places it at `.worktrees/<branch>` under the main repository root; pass its printed `path=` as the workspace root
29
29
  - **Return** — the result format expected from the specialist
30
30
 
31
31
  **Optional brief elements:**
@@ -0,0 +1 @@
1
+ When work needs a git worktree, create it at `.worktrees/<branch>` under the main repository root with the `git-worktree` skill's script. Never use raw `git worktree add`, a sibling directory, `/tmp`, or a path inside another worktree. If the user or a project instruction names a different location or tool, follow that instead.
@@ -1,34 +0,0 @@
1
- # Critical Pattern Template
2
-
3
- Use this template when adding a pattern to `docs/solutions/patterns/critical-patterns.md`:
4
-
5
- ---
6
-
7
- ## N. [Pattern Name] (ALWAYS REQUIRED)
8
-
9
- ### ❌ WRONG ([Will cause X error])
10
- ```[language]
11
- [code showing wrong approach]
12
- ```
13
-
14
- ### ✅ CORRECT
15
- ```[language]
16
- [code showing correct approach]
17
- ```
18
-
19
- **Why:** [Technical explanation of why this is required]
20
-
21
- **Placement/Context:** [When this applies]
22
-
23
- **Documented in:** `docs/solutions/[category]/[filename].md`
24
-
25
- ---
26
-
27
- **Instructions:**
28
- 1. Replace N with the next pattern number
29
- 2. Replace [Pattern Name] with descriptive title
30
- 3. Fill in WRONG example with code that causes the problem
31
- 4. Fill in CORRECT example with the solution
32
- 5. Explain the technical reason in "Why"
33
- 6. Clarify when this pattern applies in "Placement/Context"
34
- 7. Link to the full troubleshooting doc where this was originally solved
@@ -1,176 +0,0 @@
1
- # CORA Documentation Schema
2
- # This schema MUST be validated before writing any documentation file
3
-
4
- required_fields:
5
- module:
6
- type: string
7
- description: "Module/area of CORA (e.g., 'Email Processing', 'Brief System', 'Authentication')"
8
- examples:
9
- - "Email Processing"
10
- - "Brief System"
11
- - "Assistant"
12
- - "Authentication"
13
-
14
- date:
15
- type: string
16
- pattern: '^\d{4}-\d{2}-\d{2}$'
17
- description: "Date when this problem was solved (YYYY-MM-DD)"
18
-
19
- problem_type:
20
- type: enum
21
- values:
22
- - build_error # Rails, bundle, compilation errors
23
- - test_failure # Test failures, flaky tests
24
- - runtime_error # Exceptions, crashes during execution
25
- - performance_issue # Slow queries, memory issues, N+1 queries
26
- - database_issue # Migration, query, schema problems
27
- - security_issue # Authentication, authorization, XSS, SQL injection
28
- - ui_bug # Frontend, Stimulus, Turbo issues
29
- - integration_issue # External service, API integration problems
30
- - logic_error # Business logic bugs
31
- - developer_experience # DX issues: workflow, tooling, seed data, dev setup
32
- - workflow_issue # Development process, missing steps, unclear practices
33
- - best_practice # Documenting patterns and practices to follow
34
- - documentation_gap # Missing or inadequate documentation
35
- description: "Primary category of the problem"
36
-
37
- component:
38
- type: enum
39
- values:
40
- - rails_model # ActiveRecord models
41
- - rails_controller # ActionController
42
- - rails_view # ERB templates, ViewComponent
43
- - service_object # Custom service classes
44
- - background_job # Sidekiq, Active Job
45
- - database # PostgreSQL, migrations, schema
46
- - frontend_stimulus # Stimulus JS controllers
47
- - hotwire_turbo # Turbo Streams, Turbo Drive
48
- - email_processing # Email handling, mailers
49
- - brief_system # Brief generation, summarization
50
- - assistant # AI assistant, prompts
51
- - authentication # Devise, user auth
52
- - payments # Stripe, billing
53
- - development_workflow # Dev process, seed data, tooling
54
- - testing_framework # Test setup, fixtures, VCR
55
- - documentation # README, guides, inline docs
56
- - tooling # Scripts, generators, CLI tools
57
- description: "CORA component involved"
58
-
59
- symptoms:
60
- type: array[string]
61
- min_items: 1
62
- max_items: 5
63
- description: "Observable symptoms (error messages, visual issues, crashes)"
64
- examples:
65
- - "N+1 query detected in brief generation"
66
- - "Brief emails not appearing in summary"
67
- - "Turbo Stream response returns 404"
68
-
69
- root_cause:
70
- type: enum
71
- values:
72
- - missing_association # Incorrect Rails associations
73
- - missing_include # Missing eager loading (N+1)
74
- - missing_index # Database performance issue
75
- - wrong_api # Using deprecated/incorrect Rails API
76
- - scope_issue # Incorrect query scope or filtering
77
- - thread_violation # Real-time unsafe operation
78
- - async_timing # Async/background job timing
79
- - memory_leak # Memory leak or excessive allocation
80
- - config_error # Configuration or environment issue
81
- - logic_error # Algorithm/business logic bug
82
- - test_isolation # Test isolation or fixture issue
83
- - missing_validation # Missing model validation
84
- - missing_permission # Authorization check missing
85
- - missing_workflow_step # Skipped or undocumented workflow step
86
- - inadequate_documentation # Missing or unclear documentation
87
- - missing_tooling # Lacking helper scripts or automation
88
- - incomplete_setup # Missing seed data, fixtures, or config
89
- description: "Fundamental cause of the problem"
90
-
91
- resolution_type:
92
- type: enum
93
- values:
94
- - code_fix # Fixed by changing source code
95
- - migration # Fixed by database migration
96
- - config_change # Fixed by changing configuration
97
- - test_fix # Fixed by correcting tests
98
- - dependency_update # Fixed by updating gem/dependency
99
- - environment_setup # Fixed by environment configuration
100
- - workflow_improvement # Improved development workflow or process
101
- - documentation_update # Added or updated documentation
102
- - tooling_addition # Added helper script or automation
103
- - seed_data_update # Updated db/seeds.rb or fixtures
104
- description: "Type of fix applied"
105
-
106
- severity:
107
- type: enum
108
- values:
109
- - critical # Blocks production or development (build fails, data loss)
110
- - high # Impairs core functionality (feature broken, security issue)
111
- - medium # Affects specific feature (UI broken, performance impact)
112
- - low # Minor issue or edge case
113
- description: "Impact severity"
114
-
115
- optional_fields:
116
- rails_version:
117
- type: string
118
- pattern: '^\d+\.\d+\.\d+$'
119
- description: "Rails version where this was encountered (e.g., '7.1.0')"
120
-
121
- related_components:
122
- type: array[string]
123
- description: "Other components that interact with this issue"
124
-
125
- tags:
126
- type: array[string]
127
- max_items: 8
128
- description: "Searchable keywords (lowercase, hyphen-separated)"
129
- examples:
130
- - "n-plus-one"
131
- - "eager-loading"
132
- - "test-isolation"
133
- - "turbo-stream"
134
-
135
- validation_rules:
136
- - "module must be a valid CORA module name"
137
- - "date must be in YYYY-MM-DD format"
138
- - "problem_type must match one of the enum values"
139
- - "component must match one of the enum values"
140
- - "symptoms must be specific and observable (not vague)"
141
- - "root_cause must be the ACTUAL cause, not a symptom"
142
- - "resolution_type must match one of the enum values"
143
- - "severity must match one of the enum values"
144
- - "tags should be lowercase, hyphen-separated"
145
-
146
- # Example valid front matter:
147
- # ---
148
- # module: Email Processing
149
- # date: 2025-11-12
150
- # problem_type: performance_issue
151
- # component: rails_model
152
- # symptoms:
153
- # - N+1 query when loading email threads
154
- # - Brief generation taking >5 seconds
155
- # root_cause: missing_include
156
- # rails_version: 7.1.2
157
- # resolution_type: code_fix
158
- # severity: high
159
- # tags: [n-plus-one, eager-loading, performance]
160
- # ---
161
- #
162
- # Example DX issue front matter:
163
- # ---
164
- # module: Development Workflow
165
- # date: 2025-11-13
166
- # problem_type: developer_experience
167
- # component: development_workflow
168
- # symptoms:
169
- # - No example data for new feature in development
170
- # - Rails db:seed doesn't demonstrate new capabilities
171
- # root_cause: incomplete_setup
172
- # rails_version: 7.1.2
173
- # resolution_type: seed_data_update
174
- # severity: low
175
- # tags: [seed-data, dx, workflow]
176
- # ---