@orchestrator-claude/definitions 3.5.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.
Files changed (73) hide show
  1. package/agents/api-extractor.md +687 -0
  2. package/agents/business-rule-miner.md +754 -0
  3. package/agents/code-archaeologist.md +720 -0
  4. package/agents/docs-guardian.md +524 -0
  5. package/agents/implementer.md +512 -0
  6. package/agents/legacy-discoverer.md +583 -0
  7. package/agents/legacy-synthesizer.md +1101 -0
  8. package/agents/orchestrator.md +165 -0
  9. package/agents/planner.md +365 -0
  10. package/agents/researcher.md +447 -0
  11. package/agents/reviewer.md +514 -0
  12. package/agents/schema-extractor.md +781 -0
  13. package/agents/specifier.md +360 -0
  14. package/agents/task-generator.md +390 -0
  15. package/bin/orch-defs.js +2 -0
  16. package/dist/cli.d.ts +3 -0
  17. package/dist/cli.d.ts.map +1 -0
  18. package/dist/cli.js +172 -0
  19. package/dist/cli.js.map +1 -0
  20. package/dist/commands/DiffCommand.d.ts +13 -0
  21. package/dist/commands/DiffCommand.d.ts.map +1 -0
  22. package/dist/commands/DiffCommand.js +74 -0
  23. package/dist/commands/DiffCommand.js.map +1 -0
  24. package/dist/commands/SeedCommand.d.ts +19 -0
  25. package/dist/commands/SeedCommand.d.ts.map +1 -0
  26. package/dist/commands/SeedCommand.js +56 -0
  27. package/dist/commands/SeedCommand.js.map +1 -0
  28. package/dist/http/ApiClient.d.ts +50 -0
  29. package/dist/http/ApiClient.d.ts.map +1 -0
  30. package/dist/http/ApiClient.js +58 -0
  31. package/dist/http/ApiClient.js.map +1 -0
  32. package/dist/index.d.ts +12 -0
  33. package/dist/index.d.ts.map +1 -0
  34. package/dist/index.js +11 -0
  35. package/dist/index.js.map +1 -0
  36. package/dist/manifest/ManifestLoader.d.ts +34 -0
  37. package/dist/manifest/ManifestLoader.d.ts.map +1 -0
  38. package/dist/manifest/ManifestLoader.js +110 -0
  39. package/dist/manifest/ManifestLoader.js.map +1 -0
  40. package/dist/manifest/types.d.ts +59 -0
  41. package/dist/manifest/types.d.ts.map +1 -0
  42. package/dist/manifest/types.js +5 -0
  43. package/dist/manifest/types.js.map +1 -0
  44. package/dist/scripts/generate-manifest.d.ts +10 -0
  45. package/dist/scripts/generate-manifest.d.ts.map +1 -0
  46. package/dist/scripts/generate-manifest.js +114 -0
  47. package/dist/scripts/generate-manifest.js.map +1 -0
  48. package/hooks/post-agent-artifact-relay.sh +157 -0
  49. package/hooks/post-artifact-generate.sh +39 -0
  50. package/hooks/post-implement-validate.sh +139 -0
  51. package/hooks/post-phase-checkpoint.sh +322 -0
  52. package/hooks/pre-agent-invoke.sh +34 -0
  53. package/hooks/pre-phase-advance.sh +40 -0
  54. package/hooks/track-agent-invocation.sh +241 -0
  55. package/kb/auth-strategies.md +742 -0
  56. package/kb/docs-constitution.md +310 -0
  57. package/kb/error-handling.md +555 -0
  58. package/kb/rest-conventions.md +458 -0
  59. package/kb/validation-patterns.md +589 -0
  60. package/manifest.json +314 -0
  61. package/package.json +65 -0
  62. package/skills/artifact-validator/SKILL.md +226 -0
  63. package/skills/docs-guardian/SKILL.md +230 -0
  64. package/skills/kb-lookup/SKILL.md +257 -0
  65. package/skills/phase-gate-evaluator/SKILL.md +274 -0
  66. package/skills/release/SKILL.md +239 -0
  67. package/skills/release/release.sh +491 -0
  68. package/skills/smoke-test/SKILL.md +195 -0
  69. package/skills/workflow-status/SKILL.md +322 -0
  70. package/workflows/bug-fix.json +74 -0
  71. package/workflows/feature-development.json +88 -0
  72. package/workflows/legacy-analysis.json +304 -0
  73. package/workflows/refactoring.json +74 -0
@@ -0,0 +1,304 @@
1
+ {
2
+ "id": "legacy-analysis",
3
+ "name": "Legacy Application Analysis",
4
+ "version": "1.0.0",
5
+ "type": "legacy_analysis",
6
+ "description": "Systematic analysis of legacy codebases to extract documentation, identify technical debt, and generate modernization roadmaps",
7
+ "triggers": [
8
+ "analyze legacy",
9
+ "legacy analysis",
10
+ "legacy application",
11
+ "modernize application",
12
+ "reverse engineer",
13
+ "discover APIs",
14
+ "map database",
15
+ "analisar legado",
16
+ "analise de legado",
17
+ "aplicacao legada",
18
+ "modernizar aplicacao",
19
+ "engenharia reversa",
20
+ "descobrir APIs",
21
+ "mapear banco"
22
+ ],
23
+ "phases": [
24
+ {
25
+ "id": "discover",
26
+ "name": "Discovery",
27
+ "description": "Explore codebase structure and detect technology stack",
28
+ "agent": "legacy-discoverer",
29
+ "artifacts": ["discovery-report.md"],
30
+ "gates": {
31
+ "required": ["discovery-report.md"],
32
+ "validations": [
33
+ "has-stack-detected",
34
+ "has-confidence-score",
35
+ "has-directory-structure"
36
+ ]
37
+ },
38
+ "requiresApproval": false,
39
+ "estimatedDuration": "30-60min"
40
+ },
41
+ {
42
+ "id": "inventory",
43
+ "name": "Inventory",
44
+ "description": "Catalog all assets, files, and components",
45
+ "agent": "legacy-discoverer",
46
+ "artifacts": ["inventory.json"],
47
+ "gates": {
48
+ "required": ["inventory.json"],
49
+ "validations": [
50
+ "has-asset-counts",
51
+ "has-metrics",
52
+ "json-valid"
53
+ ]
54
+ },
55
+ "requiresApproval": false,
56
+ "estimatedDuration": "30-60min"
57
+ },
58
+ {
59
+ "id": "analyze",
60
+ "name": "Analysis",
61
+ "description": "Deep analysis of code quality, technical debt, and security issues",
62
+ "agent": "code-archaeologist",
63
+ "artifacts": [
64
+ "analysis-report.md",
65
+ "dead-code-report.md",
66
+ "tech-debt.md"
67
+ ],
68
+ "gates": {
69
+ "required": ["analysis-report.md"],
70
+ "validations": [
71
+ "has-severity-classification",
72
+ "has-findings",
73
+ "no-secrets-exposed"
74
+ ]
75
+ },
76
+ "requiresApproval": false,
77
+ "estimatedDuration": "1-2h"
78
+ },
79
+ {
80
+ "id": "map",
81
+ "name": "Mapping",
82
+ "description": "Extract API specifications and database schema",
83
+ "agent": "api-extractor",
84
+ "secondaryAgents": ["schema-extractor"],
85
+ "parallelizable": true,
86
+ "artifacts": [
87
+ "api-spec.yaml",
88
+ "database-schema.md",
89
+ "integrations.md"
90
+ ],
91
+ "gates": {
92
+ "required": ["api-spec.yaml", "database-schema.md"],
93
+ "validations": [
94
+ "openapi-valid",
95
+ "has-mermaid-diagram",
96
+ "has-endpoints"
97
+ ]
98
+ },
99
+ "requiresApproval": false,
100
+ "estimatedDuration": "1-2h"
101
+ },
102
+ {
103
+ "id": "document",
104
+ "name": "Documentation",
105
+ "description": "Extract and document business rules and domain logic",
106
+ "agent": "business-rule-miner",
107
+ "artifacts": [
108
+ "business-rules.md",
109
+ "glossary.md",
110
+ "flow-diagrams.md"
111
+ ],
112
+ "gates": {
113
+ "required": ["business-rules.md"],
114
+ "validations": [
115
+ "has-rules-by-domain",
116
+ "has-locations",
117
+ "has-glossary"
118
+ ]
119
+ },
120
+ "requiresApproval": false,
121
+ "estimatedDuration": "1-2h"
122
+ },
123
+ {
124
+ "id": "recommend",
125
+ "name": "Recommendations",
126
+ "description": "Synthesize findings and generate migration roadmap",
127
+ "agent": "legacy-synthesizer",
128
+ "artifacts": [
129
+ "migration-roadmap.md",
130
+ "architecture-proposal.md",
131
+ "final-report.md"
132
+ ],
133
+ "gates": {
134
+ "required": ["migration-roadmap.md", "final-report.md"],
135
+ "validations": [
136
+ "has-phases",
137
+ "has-estimates",
138
+ "has-risks",
139
+ "has-quick-wins"
140
+ ]
141
+ },
142
+ "requiresApproval": true,
143
+ "estimatedDuration": "1-2h"
144
+ }
145
+ ],
146
+ "transitions": {
147
+ "discover": ["inventory"],
148
+ "inventory": ["analyze"],
149
+ "analyze": ["map"],
150
+ "map": ["document"],
151
+ "document": ["recommend"],
152
+ "recommend": []
153
+ },
154
+ "configuration": {
155
+ "patternSets": {
156
+ "basePath": ".orchestrator/patterns/legacy",
157
+ "fallbackBehavior": "heuristic",
158
+ "defaultStack": null
159
+ },
160
+ "templates": {
161
+ "basePath": ".orchestrator/templates/legacy"
162
+ },
163
+ "artifactPath": ".orchestrator/artifacts/legacy-analysis",
164
+ "allowParallelPhases": true,
165
+ "tokenBudgetPerPhase": 50000,
166
+ "checkpointFrequency": "per-phase"
167
+ },
168
+ "gates": {
169
+ "discover": {
170
+ "has-stack-detected": {
171
+ "type": "content-check",
172
+ "description": "Discovery report must identify technology stack",
173
+ "pattern": "Stack Detected:|Technology Stack:",
174
+ "severity": "CRITICAL"
175
+ },
176
+ "has-confidence-score": {
177
+ "type": "content-check",
178
+ "description": "Must include confidence score for stack detection",
179
+ "pattern": "Confidence:|confidence.*\\d+",
180
+ "severity": "HIGH"
181
+ },
182
+ "has-directory-structure": {
183
+ "type": "content-check",
184
+ "description": "Must document directory structure",
185
+ "pattern": "Directory Structure:|Structure:",
186
+ "severity": "MEDIUM"
187
+ }
188
+ },
189
+ "inventory": {
190
+ "has-asset-counts": {
191
+ "type": "json-field",
192
+ "description": "Must include counts for all asset types",
193
+ "field": "assets",
194
+ "severity": "CRITICAL"
195
+ },
196
+ "has-metrics": {
197
+ "type": "json-field",
198
+ "description": "Must include code metrics",
199
+ "field": "metrics",
200
+ "severity": "HIGH"
201
+ },
202
+ "json-valid": {
203
+ "type": "json-validation",
204
+ "description": "Inventory must be valid JSON",
205
+ "severity": "CRITICAL"
206
+ }
207
+ },
208
+ "analyze": {
209
+ "has-severity-classification": {
210
+ "type": "content-check",
211
+ "description": "Must classify findings by severity",
212
+ "pattern": "CRITICAL|HIGH|MEDIUM|LOW",
213
+ "severity": "CRITICAL"
214
+ },
215
+ "has-findings": {
216
+ "type": "content-check",
217
+ "description": "Must document findings",
218
+ "pattern": "Findings|Issues Identified",
219
+ "severity": "HIGH"
220
+ },
221
+ "no-secrets-exposed": {
222
+ "type": "security-check",
223
+ "description": "Must not expose secrets in reports",
224
+ "pattern": "password|api[_-]?key|secret|token",
225
+ "action": "fail-if-found",
226
+ "severity": "CRITICAL"
227
+ }
228
+ },
229
+ "map": {
230
+ "openapi-valid": {
231
+ "type": "openapi-validation",
232
+ "description": "API spec must be valid OpenAPI 3.0",
233
+ "version": "3.0",
234
+ "severity": "CRITICAL"
235
+ },
236
+ "has-mermaid-diagram": {
237
+ "type": "content-check",
238
+ "description": "Database schema must include Mermaid ER diagram",
239
+ "pattern": "```mermaid|erDiagram",
240
+ "severity": "HIGH"
241
+ },
242
+ "has-endpoints": {
243
+ "type": "content-check",
244
+ "description": "API spec must document endpoints",
245
+ "pattern": "paths:",
246
+ "severity": "CRITICAL"
247
+ }
248
+ },
249
+ "document": {
250
+ "has-rules-by-domain": {
251
+ "type": "content-check",
252
+ "description": "Business rules must be categorized by domain",
253
+ "pattern": "Domain:|Category:",
254
+ "severity": "HIGH"
255
+ },
256
+ "has-locations": {
257
+ "type": "content-check",
258
+ "description": "Rules must include source file locations",
259
+ "pattern": "Location:|File:",
260
+ "severity": "MEDIUM"
261
+ },
262
+ "has-glossary": {
263
+ "type": "artifact-exists",
264
+ "description": "Glossary of domain terms must exist",
265
+ "artifact": "glossary.md",
266
+ "severity": "MEDIUM"
267
+ }
268
+ },
269
+ "recommend": {
270
+ "has-phases": {
271
+ "type": "content-check",
272
+ "description": "Roadmap must include migration phases",
273
+ "pattern": "Phase \\d+|Migration Phase",
274
+ "severity": "CRITICAL"
275
+ },
276
+ "has-estimates": {
277
+ "type": "content-check",
278
+ "description": "Must include effort estimates",
279
+ "pattern": "Estimate:|Duration:|Effort:",
280
+ "severity": "HIGH"
281
+ },
282
+ "has-risks": {
283
+ "type": "content-check",
284
+ "description": "Must document risks and mitigations",
285
+ "pattern": "Risk:|Mitigation:",
286
+ "severity": "HIGH"
287
+ },
288
+ "has-quick-wins": {
289
+ "type": "content-check",
290
+ "description": "Should identify quick win opportunities",
291
+ "pattern": "Quick Win|Low Effort",
292
+ "severity": "MEDIUM"
293
+ }
294
+ }
295
+ },
296
+ "metadata": {
297
+ "author": "implementer-agent",
298
+ "created": "2026-01-23",
299
+ "lastUpdated": "2026-01-23",
300
+ "rfc": "RFC-004-LEGACY-ANALYSIS-WORKFLOW",
301
+ "targetVersion": "v1.7.0",
302
+ "status": "active"
303
+ }
304
+ }
@@ -0,0 +1,74 @@
1
+ {
2
+ "name": "refactoring",
3
+ "type": "refactoring",
4
+ "displayName": "Refactoring",
5
+ "description": "Workflow for code refactoring and improvements",
6
+ "version": "1.0.0",
7
+ "triggers": [
8
+ "refactor",
9
+ "improve",
10
+ "cleanup",
11
+ "optimize",
12
+ "restructure",
13
+ "simplify"
14
+ ],
15
+ "phases": [
16
+ {
17
+ "name": "ANALYZE",
18
+ "displayName": "Analysis",
19
+ "agent": "researcher",
20
+ "artifact": "refactoring-analysis.md",
21
+ "gates": []
22
+ },
23
+ {
24
+ "name": "PLAN",
25
+ "displayName": "Refactoring Plan",
26
+ "agent": "planner",
27
+ "artifact": "refactoring-plan.md",
28
+ "gates": [
29
+ {
30
+ "type": "artifact",
31
+ "config": {
32
+ "required": true
33
+ }
34
+ }
35
+ ]
36
+ },
37
+ {
38
+ "name": "REFACTOR",
39
+ "displayName": "Refactoring",
40
+ "agent": "implementer",
41
+ "artifact": "refactoring-report.md",
42
+ "requiresApproval": true,
43
+ "gates": [
44
+ {
45
+ "type": "tests",
46
+ "config": {
47
+ "mustPass": true
48
+ }
49
+ },
50
+ {
51
+ "type": "coverage",
52
+ "config": {
53
+ "minimum": 80,
54
+ "maintainCurrent": true
55
+ }
56
+ }
57
+ ]
58
+ },
59
+ {
60
+ "name": "VERIFY",
61
+ "displayName": "Verification",
62
+ "agent": "reviewer",
63
+ "artifact": "verification-report.md",
64
+ "gates": [
65
+ {
66
+ "type": "tests",
67
+ "config": {
68
+ "mustPass": true
69
+ }
70
+ }
71
+ ]
72
+ }
73
+ ]
74
+ }