@fro.bot/systematic 3.26.2 → 3.26.4
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 +2 -2
- package/agents/research/learnings-researcher.md +87 -80
- package/dist/lib/pi-subagents-personas.d.ts +1 -1
- package/package.json +2 -2
- package/skills/ce-compound/SKILL.md +16 -14
- package/skills/ce-compound/assets/resolution-template.md +2 -2
- package/skills/ce-compound/references/schema.yaml +99 -15
- package/skills/ce-compound/references/yaml-schema.md +36 -7
- package/skills/ce-compound-refresh/SKILL.md +33 -16
- package/skills/ce-compound-refresh/assets/resolution-template.md +2 -2
- package/skills/ce-compound-refresh/references/schema.yaml +99 -15
- package/skills/ce-compound-refresh/references/yaml-schema.md +36 -7
- package/skills/ce-review/SKILL.md +1 -1
- package/skills/ce-review/references/review-output-template.md +1 -1
- package/skills/compound-docs/SKILL.md +75 -124
- package/skills/compound-docs/assets/resolution-template.md +65 -68
- package/skills/compound-docs/references/schema.yaml +331 -0
- package/skills/compound-docs/references/yaml-schema.md +122 -54
- package/skills/compound-docs/assets/critical-pattern-template.md +0 -34
- package/skills/compound-docs/schema.yaml +0 -176
|
@@ -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
|
-
# ---
|