@jakkrichm/create-nexus-devflow 2.0.1 → 2.0.2

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 (72) hide show
  1. package/package.json +1 -1
  2. package/template/.agents/skills/9arm-skills/README.md +3 -3
  3. package/template/.agents/skills/intelligent-routing/SKILL.md +1 -1
  4. package/template/.claude/skills/9arm-skills/README.md +3 -3
  5. package/template/.claude/skills/intelligent-routing/SKILL.md +1 -1
  6. package/template/.nexus/nexus-devflow.json +1 -1
  7. package/template/AGENTS.md +3 -3
  8. package/template/devflow/context/project_index.json +108 -0
  9. package/template/.agents/skills/check-for-updates/SKILL.md +0 -117
  10. package/template/.agents/skills/devflow-concept-intake/SKILL.md +0 -150
  11. package/template/.agents/skills/devflow-concept-intake/agents/openai.yaml +0 -4
  12. package/template/.agents/skills/devflow-concept-intake/references/adoption-proposal-template.md +0 -60
  13. package/template/.agents/skills/devflow-concept-intake/references/concept-report-template.md +0 -47
  14. package/template/.agents/skills/devflow-concept-intake/references/upstream-tracking-template.md +0 -51
  15. package/template/.agents/skills/devflow-wiki/SKILL.md +0 -75
  16. package/template/.agents/skills/english-to-thai-translator/SKILL.md +0 -125
  17. package/template/.agents/skills/obsidian-bases/SKILL.md +0 -506
  18. package/template/.agents/skills/obsidian-bases/references/FUNCTIONS_REFERENCE.md +0 -173
  19. package/template/.agents/skills/obsidian-cli/SKILL.md +0 -115
  20. package/template/.agents/skills/obsidian-clipper-template-creator/SKILL.md +0 -73
  21. package/template/.agents/skills/obsidian-clipper-template-creator/assets/clipping-template.json +0 -51
  22. package/template/.agents/skills/obsidian-clipper-template-creator/assets/recipe-template.json +0 -48
  23. package/template/.agents/skills/obsidian-clipper-template-creator/references/analysis-workflow.md +0 -79
  24. package/template/.agents/skills/obsidian-clipper-template-creator/references/bases-workflow.md +0 -44
  25. package/template/.agents/skills/obsidian-clipper-template-creator/references/filters.md +0 -51
  26. package/template/.agents/skills/obsidian-clipper-template-creator/references/json-schema.md +0 -77
  27. package/template/.agents/skills/obsidian-clipper-template-creator/references/logic.md +0 -67
  28. package/template/.agents/skills/obsidian-clipper-template-creator/references/variables.md +0 -64
  29. package/template/.agents/skills/obsidian-markdown/SKILL.md +0 -205
  30. package/template/.agents/skills/obsidian-markdown/references/CALLOUTS.md +0 -58
  31. package/template/.agents/skills/obsidian-markdown/references/EMBEDS.md +0 -63
  32. package/template/.agents/skills/obsidian-markdown/references/PROPERTIES.md +0 -61
  33. package/template/.agents/skills/prompt-addons/SKILL.md +0 -99
  34. package/template/.agents/skills/prp-dev-fastapi/SKILL.md +0 -114
  35. package/template/.agents/skills/prp-dev-multiplatform/SKILL.md +0 -36
  36. package/template/.agents/skills/prp-dev-odoo/SKILL.md +0 -71
  37. package/template/.agents/skills/prp-dev-php/SKILL.md +0 -63
  38. package/template/.agents/skills/prp-sa-ba/SKILL.md +0 -52
  39. package/template/.agents/skills/red-team-tactics/SKILL.md +0 -199
  40. package/template/.agents/skills/writing-great-skills/SKILL.md +0 -65
  41. package/template/.claude/skills/check-for-updates/SKILL.md +0 -117
  42. package/template/.claude/skills/devflow-concept-intake/SKILL.md +0 -150
  43. package/template/.claude/skills/devflow-concept-intake/agents/openai.yaml +0 -4
  44. package/template/.claude/skills/devflow-concept-intake/references/adoption-proposal-template.md +0 -60
  45. package/template/.claude/skills/devflow-concept-intake/references/concept-report-template.md +0 -47
  46. package/template/.claude/skills/devflow-concept-intake/references/upstream-tracking-template.md +0 -51
  47. package/template/.claude/skills/devflow-wiki/SKILL.md +0 -75
  48. package/template/.claude/skills/english-to-thai-translator/SKILL.md +0 -125
  49. package/template/.claude/skills/obsidian-bases/SKILL.md +0 -506
  50. package/template/.claude/skills/obsidian-bases/references/FUNCTIONS_REFERENCE.md +0 -173
  51. package/template/.claude/skills/obsidian-cli/SKILL.md +0 -115
  52. package/template/.claude/skills/obsidian-clipper-template-creator/SKILL.md +0 -73
  53. package/template/.claude/skills/obsidian-clipper-template-creator/assets/clipping-template.json +0 -51
  54. package/template/.claude/skills/obsidian-clipper-template-creator/assets/recipe-template.json +0 -48
  55. package/template/.claude/skills/obsidian-clipper-template-creator/references/analysis-workflow.md +0 -79
  56. package/template/.claude/skills/obsidian-clipper-template-creator/references/bases-workflow.md +0 -44
  57. package/template/.claude/skills/obsidian-clipper-template-creator/references/filters.md +0 -51
  58. package/template/.claude/skills/obsidian-clipper-template-creator/references/json-schema.md +0 -77
  59. package/template/.claude/skills/obsidian-clipper-template-creator/references/logic.md +0 -67
  60. package/template/.claude/skills/obsidian-clipper-template-creator/references/variables.md +0 -64
  61. package/template/.claude/skills/obsidian-markdown/SKILL.md +0 -205
  62. package/template/.claude/skills/obsidian-markdown/references/CALLOUTS.md +0 -58
  63. package/template/.claude/skills/obsidian-markdown/references/EMBEDS.md +0 -63
  64. package/template/.claude/skills/obsidian-markdown/references/PROPERTIES.md +0 -61
  65. package/template/.claude/skills/prompt-addons/SKILL.md +0 -99
  66. package/template/.claude/skills/prp-dev-fastapi/SKILL.md +0 -114
  67. package/template/.claude/skills/prp-dev-multiplatform/SKILL.md +0 -36
  68. package/template/.claude/skills/prp-dev-odoo/SKILL.md +0 -71
  69. package/template/.claude/skills/prp-dev-php/SKILL.md +0 -63
  70. package/template/.claude/skills/prp-sa-ba/SKILL.md +0 -52
  71. package/template/.claude/skills/red-team-tactics/SKILL.md +0 -199
  72. package/template/.claude/skills/writing-great-skills/SKILL.md +0 -65
@@ -1,71 +0,0 @@
1
- ---
2
- name: prp-dev-odoo
3
- description: Comprehensive skill for Odoo development following the PRP Pure Agentic workflow. Supports Odoo 8 and Odoo 13+ patterns, model/view/controller architecture, and automated validation in a Zero-Script environment.
4
- ---
5
-
6
- # 📦 PRP Dev – Odoo (Pure Agentic)
7
-
8
- This Skill operates to facilitate feature development on **Odoo** (ERP) in obedience to PRP Framework standards. It encompasses both Legacy (Odoo 8) and Modern (Odoo 13+) versions, enforcing correct Inheritance practices and optimal Security measures.
9
-
10
- ## 🎯 Scope of Work
11
- Apply this Skill when:
12
- - **Module Dev**: Building or revising Odoo Modules (Models, Views, Controllers, Wizards).
13
- - **Migration/Fix**: Squashing Bugs or ameliorating features within Odoo 8 and 13+.
14
- - **Security**: Configuring Access Rights (CSV) and Record Rules (XML).
15
- - **Workflow**: Engaging in Odoo-related tasks throughout its lifecycle.
16
-
17
- ---
18
-
19
- ## 1. 🔍 Platform & Version Detection
20
- Check the Odoo environment preceding any actions:
21
- 1. **Odoo 8**: Search for `__openerp__.py` or the `openerp` namespace.
22
- 2. **Odoo 13+**: Search for `__manifest__.py` or the `odoo` namespace.
23
- 3. **Module Structure**: Inspect directories like `addons/` or `models/`, `views/`.
24
-
25
- ---
26
-
27
- ## 2. 🧱 Implementation Guidelines
28
-
29
- ### Naming Conventions
30
- - **Module/Model**: `snake_case` (e.g., `sale_order_line`)
31
- - **Class**: `PascalCase` (e.g., `SaleOrderLine`)
32
- - **Fields**: `snake_case`
33
-
34
- ### Persistence Patterns (Inheritance)
35
- - **Model**: Leverage `_inherit` to extend an existing model's capability.
36
- - **View**: Always utilize `<xpath expr="..." position="...">` to adjust existing UI to mitigate conflict.
37
-
38
- ### Security (Mandatory)
39
- Every time a new Model is fabricated, it must include:
40
- 1. `security/ir.model.access.csv`: Group-level access rights.
41
- 2. `security/ir.rule.xml`: (If necessary) Record visibility specifications (e.g., visible only to the record owner).
42
-
43
- ---
44
-
45
- ## 3. 🛡️ Pattern References
46
-
47
- | Version | Root Header | Namespace | Decorators |
48
- |:---|:---|:---|:---|
49
- | **Odoo 8** | `<openerp>` | `from openerp import ...` | `@api.one`, `@api.multi` |
50
- | **Odoo 13+** | `<odoo>` | `from odoo import ...` | `@api.model`, `@api.depends` |
51
-
52
- ---
53
-
54
- ## 🔄 PRP Workflow Integration (Zero-Script)
55
- For each Task, the Agent must adhere to these principles:
56
-
57
- ### Phase: Planning (/30-Plan)
58
- - Designate the files to be created/modified in the `File & Directory Index`.
59
- - Formulate a `Validation Loop`:
60
- - **Step 1**: Lint (flake8/pylint-odoo)
61
- - **Step 2**: Odoo Test (`--test-enable` / `--init` module)
62
-
63
- ### Phase: Implement (/40-Implement)
64
- - Proceed with subtasks sequentially and record status in `implement.md`.
65
- - **Gotcha**: Be mindful of Odoo's Caching. Following any Python modifications, inevitably Restart the service and update the Module.
66
-
67
- ---
68
-
69
- ## 🧪 Testing & Validation
70
- - **Common Case**: Utilize `TransactionCase` to execute Business Logic Tests.
71
- - **UI Check**: Propose instructions for verification via a Browser inside `verify.md`.
@@ -1,63 +0,0 @@
1
- ---
2
- name: prp-dev-php
3
- description: Comprehensive skill for PHP development following the PRP Pure Agentic workflow. Supports CodeIgniter 3 and Yii 2, with MVC patterns and automated validation loops in a Zero-Script environment.
4
- ---
5
-
6
- # 🐘 PRP Dev – PHP (Pure Agentic)
7
-
8
- This Skill empowers feature development on **PHP** conforming to the PRP Framework standards, focusing principally on CodeIgniter 3 (Legacy) and Yii Framework 2 (Modern). It fully addresses MVC operations alongside fundamental security fortifications.
9
-
10
- ## 🎯 Scope of Work
11
- Apply this Skill when:
12
- - **Framework Dev**: Constructing or mending Controllers, Models, and Views.
13
- - **Legacy Support**: Improving CodeIgniter 3 codebases for better security and structure.
14
- - **Modern PHP**: Advancing Yii 2 exploiting ActiveRecord and Dependency Injection.
15
- - **Workflow**: Doing Task-related work pertinent to PHP Apps.
16
-
17
- ---
18
-
19
- ## 1. 🔍 Framework Detection
20
- Probe the environment prior to starting work:
21
- 1. **CodeIgniter 3**: Probe for `application/config/config.php` or `system/`.
22
- 2. **Yii 2**: Probe for `vendor/yiisoft/yii2` or `config/web.php`.
23
- 3. **Composer**: Look over `composer.json` for PHP versions and Dependencies.
24
-
25
- ---
26
-
27
- ## 2. 🏛️ Implementation Patterns
28
-
29
- ### CodeIgniter 3 (The Singleton Pattern)
30
- - **Namespacing**: Frequently lacks namespaces (Global usage).
31
- - **Loading**: Implements `$this->load->model('...')` or `$this->load->view('...')`.
32
- - **Security**: Compulsory check: `defined('BASEPATH') OR exit('...');` required universally at the top of files.
33
-
34
- ### Yii Framework 2 (The Component Pattern)
35
- - **ActiveRecord**: Fulfills Querying through Model Classes (e.g., `User::find()`).
36
- - **Namespacing**: Extensively integrates PSR-4 Namespacing.
37
- - **Views**: Incorporates `Html::encode()` alongside `$this->render()`.
38
-
39
- ---
40
-
41
- ## 🛡️ Security Best Practices
42
- - **Prepared Statements**: Mandate using the Query Builder or ORM. Raw SQL accepting direct Variables is strictly forbidden.
43
- - **Input Validation**: Abide by Framework Validation (CI Form Validation / Yii Rules).
44
- - **Output Escaping**: Obviate XSS attacks by Encoding data before displaying it on HTML.
45
-
46
- ---
47
-
48
- ## 🔄 PRP Workflow Integration (Zero-Script)
49
- For each Task, the Agent must adhere to these principles:
50
-
51
- ### Phase: Planning (/30-Plan)
52
- - Designate the files for modification and outline Validation procedures (e.g., executing `phpunit`).
53
-
54
- ### Phase: Implement (/40-Implement)
55
- - Proceed with subtasks sequentially and capture real progress in `implement.md`.
56
- - Chronicle implementation and verification-relevant notes in `implement.md` and `verify.md` first.
57
-
58
- ---
59
-
60
- ## 🧪 Testing & Validation
61
- - **Unit Testing**: Employ `PHPUnit` or any pre-installed testing framework within the project.
62
- - **Command Line**: Tests typically run via `./vendor/bin/phpunit` or specialized framework commands.
63
- - **Manual Check**: Specify manual verification steps in `verify.md`.
@@ -1,52 +0,0 @@
1
- ---
2
- name: prp-sa-ba
3
- description: Assist SA/BA in this PRP-based Pure Agentic project with requirement analysis, spec refinement, and maintaining INITIAL.md. Use whenever the user is acting as SA/BA, defining tasks, or discussing project overview.
4
- ---
5
-
6
- # 📋 PRP SA/BA Workflow (Pure Agentic)
7
-
8
- This Skill is tailored to assist users playing the role of an **SA/BA/PO** by collecting requirements and setting up specs so that the AI can work precisely thereafter in accordance with Pure Agentic Framework standards.
9
-
10
- ## 🎯 Scope of Work
11
- Apply this Skill when:
12
- - **Requirement Analysis**: Transcribing Raw requirements into an actionable plan.
13
- - **Spec Refinement**: Formatting or fine-tuning `spec.md` located in the task folder.
14
- - **Project Indexing**: Operating and updating `INITIAL.md` ensuring it acts as an up-to-date index.
15
- - **Flow Coordination**: Recommending ensuing actions within the Workflow (Issue -> Spec -> Plan -> Code -> Verify).
16
-
17
- ---
18
-
19
- ## 1. 📂 Staging to Spec (Phase: New Task)
20
- Commencing a new task:
21
- 1. **Pickup from Staging**: Monitor for specific files localized inside `devflow/issues/` (Staging Area).
22
- 2. **Standardize**: Exploit Issue data to instigate a task directory under `devflow/runs/{ID}-{slug}/`.
23
- 3. **Core Files**: Lay down standard requisite AI files:
24
- - `spec.md`: Elaborate technical nuances coupled with Acceptance Criteria.
25
- - `define.md` / `spec.md` metadata sections: informative context relating to categories, priority, and complexity.
26
-
27
- ---
28
-
29
- ## 2. 🧠 Requirement Refining
30
- Aid the SA/BA in finalizing needs thoroughly prior to writing any Code:
31
- - **Dimension 360**: Question elements about Edge Cases, UX, Security, and Technical Impacts.
32
- - **Measurable Goals**: Tweak Acceptance Criteria causing them to be quantitatively tangible (averting phrases like "make it good").
33
- - **Metadata Tuning**: Harmonize Complexity and Priority to resonate closely alongside the veritable effort needed.
34
-
35
- ---
36
-
37
- ## 3. 📑 Maintaining INITIAL.md
38
- Act as custodian of the "Home Page of Project" warranting it persists as the quintessential Source of Truth invariably:
39
- - **Indexing**: During the inception or completion of a Task, append a link right into the `Active Specs & Tasks` division.
40
- - **Stack Status**: Maintain the pertinent Technical Stack information actively updated if modifications transpire.
41
- - **Allowed Commands**: Audit alongside updating explicit lists highlighting commands currently actionable by the AI.
42
-
43
- ---
44
-
45
- ## 🔄 Workflow Guidance (Next Steps)
46
- Advocate relevant commands following the DevFlow 2.0 hierarchy:
47
- 1. **Planning**: Once a spec matures sufficiently, advise executing `/30-Plan {ID}`.
48
- 2. **Implementation**: After the plan is ready, endorse launching `/40-Implement {ID}`.
49
- 3. **Review**: After implementation evidence exists, point the user to `/50-Verify {ID}`, then `/60-Report {ID}`, and finally `/70-Release {ID}` when release execution is still needed.
50
-
51
- ---
52
- *Note: This skill synergizes most efficiently running alongside the Agent Persona `requirements-engineer`.*
@@ -1,199 +0,0 @@
1
- ---
2
- name: red-team-tactics
3
- description: Red team tactics principles based on MITRE ATT&CK. Attack phases, detection evasion, reporting.
4
- allowed-tools: Read, Glob, Grep
5
- ---
6
-
7
- # Red Team Tactics
8
-
9
- > Adversary simulation principles based on MITRE ATT&CK framework.
10
-
11
- ---
12
-
13
- ## 1. MITRE ATT&CK Phases
14
-
15
- ### Attack Lifecycle
16
-
17
- ```
18
- RECONNAISSANCE → INITIAL ACCESS → EXECUTION → PERSISTENCE
19
- ↓ ↓ ↓ ↓
20
- PRIVILEGE ESC → DEFENSE EVASION → CRED ACCESS → DISCOVERY
21
- ↓ ↓ ↓ ↓
22
- LATERAL MOVEMENT → COLLECTION → C2 → EXFILTRATION → IMPACT
23
- ```
24
-
25
- ### Phase Objectives
26
-
27
- | Phase | Objective |
28
- |-------|-----------|
29
- | **Recon** | Map attack surface |
30
- | **Initial Access** | Get first foothold |
31
- | **Execution** | Run code on target |
32
- | **Persistence** | Survive reboots |
33
- | **Privilege Escalation** | Get admin/root |
34
- | **Defense Evasion** | Avoid detection |
35
- | **Credential Access** | Harvest credentials |
36
- | **Discovery** | Map internal network |
37
- | **Lateral Movement** | Spread to other systems |
38
- | **Collection** | Gather target data |
39
- | **C2** | Maintain command channel |
40
- | **Exfiltration** | Extract data |
41
-
42
- ---
43
-
44
- ## 2. Reconnaissance Principles
45
-
46
- ### Passive vs Active
47
-
48
- | Type | Trade-off |
49
- |------|-----------|
50
- | **Passive** | No target contact, limited info |
51
- | **Active** | Direct contact, more detection risk |
52
-
53
- ### Information Targets
54
-
55
- | Category | Value |
56
- |----------|-------|
57
- | Technology stack | Attack vector selection |
58
- | Employee info | Social engineering |
59
- | Network ranges | Scanning scope |
60
- | Third parties | Supply chain attack |
61
-
62
- ---
63
-
64
- ## 3. Initial Access Vectors
65
-
66
- ### Selection Criteria
67
-
68
- | Vector | When to Use |
69
- |--------|-------------|
70
- | **Phishing** | Human target, email access |
71
- | **Public exploits** | Vulnerable services exposed |
72
- | **Valid credentials** | Leaked or cracked |
73
- | **Supply chain** | Third-party access |
74
-
75
- ---
76
-
77
- ## 4. Privilege Escalation Principles
78
-
79
- ### Windows Targets
80
-
81
- | Check | Opportunity |
82
- |-------|-------------|
83
- | Unquoted service paths | Write to path |
84
- | Weak service permissions | Modify service |
85
- | Token privileges | Abuse SeDebug, etc. |
86
- | Stored credentials | Harvest |
87
-
88
- ### Linux Targets
89
-
90
- | Check | Opportunity |
91
- |-------|-------------|
92
- | SUID binaries | Execute as owner |
93
- | Sudo misconfiguration | Command execution |
94
- | Kernel vulnerabilities | Kernel exploits |
95
- | Cron jobs | Writable scripts |
96
-
97
- ---
98
-
99
- ## 5. Defense Evasion Principles
100
-
101
- ### Key Techniques
102
-
103
- | Technique | Purpose |
104
- |-----------|---------|
105
- | LOLBins | Use legitimate tools |
106
- | Obfuscation | Hide malicious code |
107
- | Timestomping | Hide file modifications |
108
- | Log clearing | Remove evidence |
109
-
110
- ### Operational Security
111
-
112
- - Work during business hours
113
- - Mimic legitimate traffic patterns
114
- - Use encrypted channels
115
- - Blend with normal behavior
116
-
117
- ---
118
-
119
- ## 6. Lateral Movement Principles
120
-
121
- ### Credential Types
122
-
123
- | Type | Use |
124
- |------|-----|
125
- | Password | Standard auth |
126
- | Hash | Pass-the-hash |
127
- | Ticket | Pass-the-ticket |
128
- | Certificate | Certificate auth |
129
-
130
- ### Movement Paths
131
-
132
- - Admin shares
133
- - Remote services (RDP, SSH, WinRM)
134
- - Exploitation of internal services
135
-
136
- ---
137
-
138
- ## 7. Active Directory Attacks
139
-
140
- ### Attack Categories
141
-
142
- | Attack | Target |
143
- |--------|--------|
144
- | Kerberoasting | Service account passwords |
145
- | AS-REP Roasting | Accounts without pre-auth |
146
- | DCSync | Domain credentials |
147
- | Golden Ticket | Persistent domain access |
148
-
149
- ---
150
-
151
- ## 8. Reporting Principles
152
-
153
- ### Attack Narrative
154
-
155
- Document the full attack chain:
156
- 1. How initial access was gained
157
- 2. What techniques were used
158
- 3. What objectives were achieved
159
- 4. Where detection failed
160
-
161
- ### Detection Gaps
162
-
163
- For each successful technique:
164
- - What should have detected it?
165
- - Why didn't detection work?
166
- - How to improve detection
167
-
168
- ---
169
-
170
- ## 9. Ethical Boundaries
171
-
172
- ### Always
173
-
174
- - Stay within scope
175
- - Minimize impact
176
- - Report immediately if real threat found
177
- - Document all actions
178
-
179
- ### Never
180
-
181
- - Destroy production data
182
- - Cause denial of service (unless scoped)
183
- - Access beyond proof of concept
184
- - Retain sensitive data
185
-
186
- ---
187
-
188
- ## 10. Anti-Patterns
189
-
190
- | ❌ Don't | ✅ Do |
191
- |----------|-------|
192
- | Rush to exploitation | Follow methodology |
193
- | Cause damage | Minimize impact |
194
- | Skip reporting | Document everything |
195
- | Ignore scope | Stay within boundaries |
196
-
197
- ---
198
-
199
- > **Remember:** Red team simulates attackers to improve defenses, not to cause harm.
@@ -1,65 +0,0 @@
1
- ---
2
- name: writing-great-skills
3
- description: Maintainer reference for writing predictable DevFlow skills. Use when creating, importing, pruning, or refactoring .agent/skills content.
4
- disable-model-invocation: true
5
- ---
6
-
7
- # Writing Great Skills
8
-
9
- Use this maintainer support skill when editing `.agent/skills`.
10
-
11
- A skill exists to make a process predictable. It should make the agent take the same kind of action in the same kind of situation, without bloating context or competing with workflow ownership.
12
-
13
- ## Invocation
14
-
15
- Choose the lowest-load invocation mode:
16
-
17
- - Model-invoked skill: use when the agent must discover and apply the skill on its own.
18
- - User-invoked skill: use when only humans or another explicit router should call it.
19
- - Router skill: use when many user-invoked skills create cognitive load.
20
-
21
- In DevFlow, public workflow surface should stay stable. New skills usually start as support skills, not public companion commands.
22
-
23
- ## Description Rules
24
-
25
- - Front-load the leading word.
26
- - Include only distinct trigger branches.
27
- - Remove synonyms that repeat the same trigger.
28
- - Keep stage ownership out of the description; put lifecycle placement in the body.
29
-
30
- ## Information Hierarchy
31
-
32
- Put material where it belongs:
33
-
34
- 1. In-skill steps: actions every invocation needs.
35
- 2. In-skill reference: rules frequently needed during execution.
36
- 3. External reference files: details only some branches need.
37
-
38
- Use progressive disclosure for long reference material.
39
-
40
- ## Splitting Rules
41
-
42
- Split a skill only when:
43
-
44
- - it needs independent model invocation
45
- - a long step sequence causes premature completion
46
- - branches are different enough that one file causes confusion
47
-
48
- Do not split only because a file is aesthetically long.
49
-
50
- ## Pruning Rules
51
-
52
- - Keep one source of truth for each rule.
53
- - Delete no-op advice that does not change behavior.
54
- - Delete stale upstream assumptions when importing.
55
- - Prefer DevFlow stage names and artifact paths.
56
-
57
- ## Import Checklist
58
-
59
- - [ ] Fits `docs/skill-selection-policy.md`.
60
- - [ ] Does not create a new mainline stage.
61
- - [ ] Does not expand public companion commands by accident.
62
- - [ ] Names owning DevFlow stages.
63
- - [ ] Describes output location.
64
- - [ ] Routes contradictions back to the owning stage.
65
- - [ ] Passes `npm run validate`.