@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,205 +0,0 @@
1
- ---
2
- name: obsidian-markdown
3
- description: Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes.
4
- risk: unknown
5
- source: "https://github.com/kepano/obsidian-skills"
6
- date_added: "2026-03-21"
7
- ---
8
-
9
- # Obsidian Flavored Markdown Skill
10
-
11
- Create and edit valid Obsidian Flavored Markdown. Obsidian extends CommonMark and GFM with wikilinks, embeds, callouts, properties, comments, and other syntax. This skill covers only Obsidian-specific extensions -- standard Markdown (headings, bold, italic, lists, quotes, code blocks, tables) is assumed knowledge.
12
-
13
- ## When to Use
14
-
15
- - Use when writing or editing Markdown notes intended for Obsidian.
16
- - Use when the task involves wikilinks, embeds, callouts, frontmatter properties, or Obsidian-specific syntax.
17
- - Use when the user wants notes that render correctly inside an Obsidian vault.
18
-
19
- ## Workflow: Creating an Obsidian Note
20
-
21
- 1. **Add frontmatter** with properties (title, tags, aliases) at the top of the file. See [PROPERTIES.md](references/PROPERTIES.md) for all property types.
22
- 2. **Write content** using standard Markdown for structure, plus Obsidian-specific syntax below.
23
- 3. **Link related notes** using wikilinks (`[[Note]]`) for internal vault connections, or standard Markdown links for external URLs.
24
- 4. **Embed content** from other notes, images, or PDFs using the `![[embed]]` syntax. See [EMBEDS.md](references/EMBEDS.md) for all embed types.
25
- 5. **Add callouts** for highlighted information using `> [!type]` syntax. See [CALLOUTS.md](references/CALLOUTS.md) for all callout types.
26
- 6. **Verify** the note renders correctly in Obsidian's reading view.
27
-
28
- > When choosing between wikilinks and Markdown links: use `[[wikilinks]]` for notes within the vault (Obsidian tracks renames automatically) and plain Markdown links for external URLs only.
29
-
30
- ## Internal Links (Wikilinks)
31
-
32
- ```markdown
33
- [[Note Name]] Link to note
34
- [[Note Name|Display Text]] Custom display text
35
- [[Note Name#Heading]] Link to heading
36
- [[Note Name#^block-id]] Link to block
37
- [[#Heading in same note]] Same-note heading link
38
- ```
39
-
40
- Define a block ID by appending `^block-id` to any paragraph:
41
-
42
- ```markdown
43
- This paragraph can be linked to. ^my-block-id
44
- ```
45
-
46
- For lists and quotes, place the block ID on a separate line after the block:
47
-
48
- ```markdown
49
- > A quote block
50
-
51
- ^quote-id
52
- ```
53
-
54
- ## Embeds
55
-
56
- Prefix any wikilink with `!` to embed its content inline:
57
-
58
- ```markdown
59
- ![[Note Name]] Embed full note
60
- ![[Note Name#Heading]] Embed section
61
- ![[image.png]] Embed image
62
- ![[image.png|300]] Embed image with width
63
- ![[document.pdf#page=3]] Embed PDF page
64
- ```
65
-
66
- See [EMBEDS.md](references/EMBEDS.md) for audio, video, search embeds, and external images.
67
-
68
- ## Callouts
69
-
70
- ```markdown
71
- > [!note]
72
- > Basic callout.
73
-
74
- > [!warning] Custom Title
75
- > Callout with a custom title.
76
-
77
- > [!faq]- Collapsed by default
78
- > Foldable callout (- collapsed, + expanded).
79
- ```
80
-
81
- Common types: `note`, `tip`, `warning`, `info`, `example`, `quote`, `bug`, `danger`, `success`, `failure`, `question`, `abstract`, `todo`.
82
-
83
- See [CALLOUTS.md](references/CALLOUTS.md) for the full list with aliases, nesting, and custom CSS callouts.
84
-
85
- ## Properties (Frontmatter)
86
-
87
- ```yaml
88
- ---
89
- title: My Note
90
- date: 2024-01-15
91
- tags:
92
- - project
93
- - active
94
- aliases:
95
- - Alternative Name
96
- cssclasses:
97
- - custom-class
98
- ---
99
- ```
100
-
101
- Default properties: `tags` (searchable labels), `aliases` (alternative note names for link suggestions), `cssclasses` (CSS classes for styling).
102
-
103
- See [PROPERTIES.md](references/PROPERTIES.md) for all property types, tag syntax rules, and advanced usage.
104
-
105
- ## Tags
106
-
107
- ```markdown
108
- #tag Inline tag
109
- #nested/tag Nested tag with hierarchy
110
- ```
111
-
112
- Tags can contain letters, numbers (not first character), underscores, hyphens, and forward slashes. Tags can also be defined in frontmatter under the `tags` property.
113
-
114
- ## Comments
115
-
116
- ```markdown
117
- This is visible %%but this is hidden%% text.
118
-
119
- %%
120
- This entire block is hidden in reading view.
121
- %%
122
- ```
123
-
124
- ## Obsidian-Specific Formatting
125
-
126
- ```markdown
127
- ==Highlighted text== Highlight syntax
128
- ```
129
-
130
- ## Math (LaTeX)
131
-
132
- ```markdown
133
- Inline: $e^{i\pi} + 1 = 0$
134
-
135
- Block:
136
- $$
137
- \frac{a}{b} = c
138
- $$
139
- ```
140
-
141
- ## Diagrams (Mermaid)
142
-
143
- ````markdown
144
- ```mermaid
145
- graph TD
146
- A[Start] --> B{Decision}
147
- B -->|Yes| C[Do this]
148
- B -->|No| D[Do that]
149
- ```
150
- ````
151
-
152
- To link Mermaid nodes to Obsidian notes, add `class NodeName internal-link;`.
153
-
154
- ## Footnotes
155
-
156
- ```markdown
157
- Text with a footnote[^1].
158
-
159
- [^1]: Footnote content.
160
-
161
- Inline footnote.^[This is inline.]
162
- ```
163
-
164
- ## Complete Example
165
-
166
- ````markdown
167
- ---
168
- title: Project Alpha
169
- date: 2024-01-15
170
- tags:
171
- - project
172
- - active
173
- status: in-progress
174
- ---
175
-
176
- # Project Alpha
177
-
178
- This project aims to [[improve workflow]] using modern techniques.
179
-
180
- > [!important] Key Deadline
181
- > The first milestone is due on ==January 30th==.
182
-
183
- ## Tasks
184
-
185
- - [x] Initial planning
186
- - [ ] Development phase
187
- - [ ] Backend implementation
188
- - [ ] Frontend design
189
-
190
- ## Notes
191
-
192
- The algorithm uses $O(n \log n)$ sorting. See [[Algorithm Notes#Sorting]] for details.
193
-
194
- ![[Architecture Diagram.png|600]]
195
-
196
- Reviewed in [[Meeting Notes 2024-01-10#Decisions]].
197
- ````
198
-
199
- ## References
200
-
201
- - [Obsidian Flavored Markdown](https://help.obsidian.md/obsidian-flavored-markdown)
202
- - [Internal links](https://help.obsidian.md/links)
203
- - [Embed files](https://help.obsidian.md/embeds)
204
- - [Callouts](https://help.obsidian.md/callouts)
205
- - [Properties](https://help.obsidian.md/properties)
@@ -1,58 +0,0 @@
1
- # Callouts Reference
2
-
3
- ## Basic Callout
4
-
5
- ```markdown
6
- > [!note]
7
- > This is a note callout.
8
-
9
- > [!info] Custom Title
10
- > This callout has a custom title.
11
-
12
- > [!tip] Title Only
13
- ```
14
-
15
- ## Foldable Callouts
16
-
17
- ```markdown
18
- > [!faq]- Collapsed by default
19
- > This content is hidden until expanded.
20
-
21
- > [!faq]+ Expanded by default
22
- > This content is visible but can be collapsed.
23
- ```
24
-
25
- ## Nested Callouts
26
-
27
- ```markdown
28
- > [!question] Outer callout
29
- > > [!note] Inner callout
30
- > > Nested content
31
- ```
32
-
33
- ## Supported Callout Types
34
-
35
- | Type | Aliases | Color / Icon |
36
- |------|---------|-------------|
37
- | `note` | - | Blue, pencil |
38
- | `abstract` | `summary`, `tldr` | Teal, clipboard |
39
- | `info` | - | Blue, info |
40
- | `todo` | - | Blue, checkbox |
41
- | `tip` | `hint`, `important` | Cyan, flame |
42
- | `success` | `check`, `done` | Green, checkmark |
43
- | `question` | `help`, `faq` | Yellow, question mark |
44
- | `warning` | `caution`, `attention` | Orange, warning |
45
- | `failure` | `fail`, `missing` | Red, X |
46
- | `danger` | `error` | Red, zap |
47
- | `bug` | - | Red, bug |
48
- | `example` | - | Purple, list |
49
- | `quote` | `cite` | Gray, quote |
50
-
51
- ## Custom Callouts (CSS)
52
-
53
- ```css
54
- .callout[data-callout="custom-type"] {
55
- --callout-color: 255, 0, 0;
56
- --callout-icon: lucide-alert-circle;
57
- }
58
- ```
@@ -1,63 +0,0 @@
1
- # Embeds Reference
2
-
3
- ## Embed Notes
4
-
5
- ```markdown
6
- ![[Note Name]]
7
- ![[Note Name#Heading]]
8
- ![[Note Name#^block-id]]
9
- ```
10
-
11
- ## Embed Images
12
-
13
- ```markdown
14
- ![[image.png]]
15
- ![[image.png|640x480]] Width x Height
16
- ![[image.png|300]] Width only (maintains aspect ratio)
17
- ```
18
-
19
- ## External Images
20
-
21
- ```markdown
22
- ![Alt text](https://example.com/image.png)
23
- ![Alt text|300](https://example.com/image.png)
24
- ```
25
-
26
- ## Embed Audio
27
-
28
- ```markdown
29
- ![[audio.mp3]]
30
- ![[audio.ogg]]
31
- ```
32
-
33
- ## Embed PDF
34
-
35
- ```markdown
36
- ![[document.pdf]]
37
- ![[document.pdf#page=3]]
38
- ![[document.pdf#height=400]]
39
- ```
40
-
41
- ## Embed Lists
42
-
43
- ```markdown
44
- ![[Note#^list-id]]
45
- ```
46
-
47
- Where the list has a block ID:
48
-
49
- ```markdown
50
- - Item 1
51
- - Item 2
52
- - Item 3
53
-
54
- ^list-id
55
- ```
56
-
57
- ## Embed Search Results
58
-
59
- ````markdown
60
- ```query
61
- tag:#project status:done
62
- ```
63
- ````
@@ -1,61 +0,0 @@
1
- # Properties (Frontmatter) Reference
2
-
3
- Properties use YAML frontmatter at the start of a note:
4
-
5
- ```yaml
6
- ---
7
- title: My Note Title
8
- date: 2024-01-15
9
- tags:
10
- - project
11
- - important
12
- aliases:
13
- - My Note
14
- - Alternative Name
15
- cssclasses:
16
- - custom-class
17
- status: in-progress
18
- rating: 4.5
19
- completed: false
20
- due: 2024-02-01T14:30:00
21
- ---
22
- ```
23
-
24
- ## Property Types
25
-
26
- | Type | Example |
27
- |------|---------|
28
- | Text | `title: My Title` |
29
- | Number | `rating: 4.5` |
30
- | Checkbox | `completed: true` |
31
- | Date | `date: 2024-01-15` |
32
- | Date & Time | `due: 2024-01-15T14:30:00` |
33
- | List | `tags: [one, two]` or YAML list |
34
- | Links | `related: "[[Other Note]]"` |
35
-
36
- ## Default Properties
37
-
38
- - `tags` - Note tags (searchable, shown in graph view)
39
- - `aliases` - Alternative names for the note (used in link suggestions)
40
- - `cssclasses` - CSS classes applied to the note in reading/editing view
41
-
42
- ## Tags
43
-
44
- ```markdown
45
- #tag
46
- #nested/tag
47
- #tag-with-dashes
48
- #tag_with_underscores
49
- ```
50
-
51
- Tags can contain: letters (any language), numbers (not first character), underscores `_`, hyphens `-`, forward slashes `/` (for nesting).
52
-
53
- In frontmatter:
54
-
55
- ```yaml
56
- ---
57
- tags:
58
- - tag1
59
- - nested/tag2
60
- ---
61
- ```
@@ -1,99 +0,0 @@
1
- ---
2
- name: prompt-addons
3
- description: Routes external prompt families into DevFlow 2.0 workflows, specialist agents, or thin skill aliases. Use when deciding whether a prompt-inspired behavior should become a mainline workflow, a companion command, a reusable skill, or remain legacy-only.
4
- ---
5
-
6
- # Prompt Addons
7
-
8
- Use this skill when adapting outside prompt patterns into the DevFlow 2.0 system.
9
-
10
- ## Core Rule
11
-
12
- Adapt intent, not old output contracts.
13
-
14
- DevFlow 2.0 uses a stage-based, markdown-first model:
15
-
16
- 1. Mainline workflow stays minimal and ordered
17
- 2. Companion commands exist for non-mainline help
18
- 3. Specialist agents and skills handle reusable methods
19
- 4. JSON-first orchestration is legacy and should not define new architecture
20
-
21
- ## Mainline Routing
22
-
23
- | Need | Route to |
24
- | :--- | :--- |
25
- | Explore problem space | `/00-Discover` |
26
- | Clarify goal, scope, decisions | `/10-Define` |
27
- | Lock delivery contract | `/20-Spec` |
28
- | Break into execution plan | `/30-Plan` |
29
- | Build the change | `/40-Implement` |
30
- | Validate quality and evidence | `/50-Verify` |
31
- | Package release-ready outcome | `/70-Release` |
32
- | Summarize the full run | `/60-Report` |
33
-
34
- ## Companion Command Routing
35
-
36
- | Command | Use when | Typical stage pairing |
37
- | :--- | :--- | :--- |
38
- | `Brainstorm` | เน‚เธˆเธ—เธขเนŒเธขเธฑเธ‡เน„เธกเนˆเธ™เธดเนˆเธ‡ เธ•เน‰เธญเธ‡เธ„เธดเธ”เธ—เธฒเธ‡เน€เธฅเธทเธญเธเธเนˆเธญเธ™ lock | Discover, Define |
39
- | `Research` | เธ•เน‰เธญเธ‡เธซเธฒเธซเธฅเธฑเธเธเธฒเธ™เธซเธฃเธทเธญเธ‚เน‰เธญเธกเธนเธฅเน€เธžเธดเนˆเธก | Discover, Define, Spec, Verify |
40
- | `Debug` | เธ‡เธฒเธ™เธœเธดเธ”เธ›เธเธ•เธด เธ•เน‰เธญเธ‡เธซเธฒ root cause | Implement, Verify |
41
- | `Preview` | เธ•เน‰เธญเธ‡เธ•เธฃเธงเธˆเธŠเธดเน‰เธ™เธ‡เธฒเธ™เธฃเธฐเธซเธงเนˆเธฒเธ‡เธ—เธฒเธ‡ | Implement, Verify |
42
- | `Wiki` | เธ•เน‰เธญเธ‡เธชเธเธฑเธ”เธ„เธงเธฒเธกเธฃเธนเน‰ reusable | Verify, Release, Report |
43
- | `Help` | เธœเธนเน‰เนƒเธŠเน‰เน„เธกเนˆเนเธ™เนˆเนƒเธˆเธงเนˆเธฒเธˆเธฐเน€เธฃเธดเนˆเธกเธ•เธฃเธ‡เน„เธซเธ™ | เธเนˆเธญเธ™เน€เธ‚เน‰เธฒ stage เธซเธฃเธทเธญเธฃเธฐเธซเธงเนˆเธฒเธ‡เธ—เธฒเธ‡ |
44
-
45
- ## Classification Rule
46
-
47
- เธเนˆเธญเธ™เธชเธฃเน‰เธฒเธ‡ workflow เนƒเธซเธกเนˆ เนƒเธซเน‰เธˆเธฑเธ”เธ›เธฃเธฐเน€เธ เธ—เธเนˆเธญเธ™:
48
-
49
- 1. เธ–เน‰เธฒ intent เน€เธ›เธฅเธตเนˆเธขเธ™ stage เธ‚เธญเธ‡เธ‡เธฒเธ™ เนƒเธซเน‰ route เน€เธ‚เน‰เธฒเธชเธนเนˆ mainline stage เธ—เธตเนˆเธกเธตเธญเธขเธนเนˆ
50
- 2. เธ–เน‰เธฒเน€เธ›เน‡เธ™เธงเธดเธ˜เธตเธ—เธณเธ‡เธฒเธ™เธ—เธตเนˆเนƒเธŠเน‰เธ‹เน‰เธณเธซเธฅเธฒเธข stage เนƒเธซเน‰เน€เธ›เน‡เธ™ skill
51
- 3. เธ–เน‰เธฒเน€เธ›เน‡เธ™เธ„เธงเธฒเธกเน€เธŠเธตเนˆเธขเธงเธŠเธฒเธเน€เธ‰เธžเธฒเธฐเธ”เน‰เธฒเธ™ เนƒเธซเน‰เน€เธ›เน‡เธ™ agent
52
- 4. เธ–เน‰เธฒเน€เธ›เน‡เธ™เนเธ„เนˆเธ•เธฑเธงเธŠเนˆเธงเธขเธ„เธดเธ”เธซเธฃเธทเธญเธซเธฒเธซเธฅเธฑเธเธเธฒเธ™เธฃเธฐเธซเธงเนˆเธฒเธ‡เธ—เธฒเธ‡ เนƒเธซเน‰เน€เธ›เน‡เธ™ companion command
53
- 5. เธ–เน‰เธฒเธญเธดเธ‡ dashboard/json orchestration เน€เธ”เธดเธกเน€เธ›เน‡เธ™เธซเธฅเธฑเธ เนƒเธซเน‰เธ„เธ‡เน„เธงเน‰เน€เธ›เน‡เธ™ legacy เธซเธฃเธทเธญ migration note
54
-
55
- ## Prompt Family Routing
56
-
57
- | Family | DevFlow 2.0 route | Keep as |
58
- | :--- | :--- | :--- |
59
- | Spec | `/10-Define`, `/20-Spec`, `/30-Plan` | workflow + `requirements-engineer` |
60
- | Complexity | `/10-Define`, `/30-Plan` | workflow content, not standalone mainline |
61
- | Roadmap | Discover/Define adjacent | skill or optional workflow outside core line |
62
- | Ideation | `Brainstorm`, `Research` | companion command |
63
- | Competitor | `Research` during Discover/Define | companion command or research skill |
64
- | Insight | `Wiki`, `/60-Report` | companion command + report content |
65
- | Coder | `/40-Implement` | workflow + specialist agents |
66
- | QA | `/50-Verify` | workflow + QA/test skills |
67
- | Follow-up | `/10-Define` or `/30-Plan` เธ‚เธญเธ‡เธฃเธญเธšเนƒเธซเธกเนˆ | stage reuse, not separate numbered mainline |
68
- | GitHub review | `/50-Verify`, `/70-Release` | workflow/agent support |
69
- | MCP tool validation | `/50-Verify` | tool-specific verification skill |
70
-
71
- ## Borderline Rules
72
-
73
- | Idea | Route | Keep as | Rule |
74
- | :--- | :--- | :--- | :--- |
75
- | Validation fixer | `/50-Verify` เนเธฅเน‰เธงเธ„เนˆเธญเธขเธขเน‰เธญเธ™ `/40-Implement` เธ–เน‰เธฒเธ•เน‰เธญเธ‡เนเธเน‰เน‚เธ„เน‰เธ” | thin skill/process note | เนƒเธซเน‰ verification เธŠเธตเน‰ failure เธเนˆเธญเธ™เน€เธชเธกเธญ |
76
- | Documentation ideation | `Brainstorm`, `Wiki`, `/60-Report` | skill-backed support | เน„เธกเนˆเธ•เน‰เธญเธ‡เน€เธ›เธดเธ” mainline เนƒเธซเธกเนˆ |
77
- | Performance ideation | `/50-Verify` เธซเธฃเธทเธญ `/40-Implement` เน€เธกเธทเนˆเธญเธกเธตเธซเธฅเธฑเธเธเธฒเธ™ | specialist skill/agent | เธ•เน‰เธญเธ‡เธกเธต measurement |
78
- | Security ideation | `/50-Verify` เธซเธฃเธทเธญ `Debug` เน€เธกเธทเนˆเธญเธกเธต incident symptom | specialist skill/agent | treat as finding-first |
79
- | Follow-up planning | `/10-Define` -> `/20-Spec` -> `/30-Plan` เธ‚เธญเธ‡เธฃเธญเธšเนƒเธซเธกเนˆ | mainline reuse | เน„เธกเนˆเนเธขเธ workflow เธซเธกเธฒเธขเน€เธฅเธ‚เนƒเธซเธกเนˆ |
80
- | Legacy dashboard orchestration | legacy note only | migration-only | เน„เธกเนˆเนƒเธŠเน‰เน€เธ›เน‡เธ™เนเธšเธšเธ•เธฑเน‰เธ‡เธ•เน‰เธ™เธ‚เธญเธ‡ DevFlow 2.0 |
81
-
82
- ## Follow-Up Planning
83
-
84
- เน€เธกเธทเนˆเธญเธœเธนเน‰เนƒเธŠเน‰เธ•เน‰เธญเธ‡เธเธฒเธฃเธ•เนˆเธญเธขเธญเธ”เธ‡เธฒเธ™เน€เธ”เธดเธก:
85
-
86
- 1. เธญเนˆเธฒเธ™ stage artifacts เธ—เธตเนˆเธกเธตเธญเธขเธนเนˆเธ‚เธญเธ‡ running ID เน€เธ”เธดเธก
87
- 2. เธฃเธฐเธšเธธเนƒเธซเน‰เธŠเธฑเธ”เธงเนˆเธฒเธญเธฐเน„เธฃ lock เนเธฅเน‰เธง เนเธฅเธฐเธญเธฐเน„เธฃเธˆเธฐเน€เธžเธดเนˆเธกเนƒเธซเธกเนˆ
88
- 3. เน€เธฃเธดเนˆเธกเธฃเธญเธšเนƒเธซเธกเนˆเธˆเธฒเธ `/10-Define` เธ–เน‰เธฒเน‚เธˆเธ—เธขเนŒเน€เธ›เธฅเธตเนˆเธขเธ™ เธซเธฃเธทเธญ `/30-Plan` เธ–เน‰เธฒ spec เธขเธฑเธ‡เนƒเธŠเน‰เน„เธ”เน‰
89
- 4. เนƒเธŠเน‰เน„เธŸเธฅเนŒ `.md` เธ‚เธญเธ‡ stage เนƒเธซเธกเนˆเน€เธ›เน‡เธ™เธซเธฅเธฑเธเนƒเธ™เธเธฒเธฃเธšเธฑเธ™เธ—เธถเธเธšเธฃเธดเธšเธ—
90
-
91
- ## Output Principle
92
-
93
- เน€เธกเธทเนˆเธญ prompt family เธ–เธนเธเนเธ›เธฅเธ‡เน€เธ‚เน‰เธฒเธฃเธฐเธšเธš:
94
-
95
- 1. เธญเธขเนˆเธฒ copy contract เน€เธ”เธดเธกเน€เธ‚เน‰เธฒเธกเธฒเธ•เธฃเธ‡ เน†
96
- 2. เนเธ›เธฅเธ‡เนƒเธซเน‰เธชเธญเธ”เธ„เธฅเน‰เธญเธ‡เธเธฑเธš numbering rule เธ‚เธญเธ‡ DevFlow 2.0
97
- 3. เธญเธขเนˆเธฒเธ—เธณเนƒเธซเน‰เธœเธนเน‰เนƒเธŠเน‰เธ•เน‰เธญเธ‡เน€เธ”เธฒเน€เธฅเธ‚เธขเน‰เธญเธ™เธเธฅเธฑเธš
98
- 4. เนƒเธซเน‰ mainline เธกเธตเน€เธ‰เธžเธฒเธฐ state เธ‚เธญเธ‡เธ‡เธฒเธ™
99
- 5. เนƒเธซเน‰เธ„เธงเธฒเธกเธชเธฒเธกเธฒเธฃเธ–เน€เธชเธฃเธดเธกเน„เธ›เธญเธขเธนเนˆเนƒเธ™ skill, agent, เธซเธฃเธทเธญ companion command เธ•เธฒเธกเธ„เธงเธฒเธกเน€เธซเธกเธฒเธฐเธชเธก
@@ -1,114 +0,0 @@
1
- ---
2
- name: prp-dev-fastapi
3
- description: Comprehensive skill for FastAPI development following the PRP Pure Agentic workflow. Includes project templates, async/await patterns, Pydantic validation, repository/service architecture, and automated validation loops. Use when designing, implementation, or refactoring FastAPI applications.
4
- ---
5
-
6
- # ๐Ÿš€ PRP Dev โ€“ FastAPI (Pure Agentic)
7
-
8
- This Skill operates to assist the AI Agent in systematically developing features for **FastAPI** following the PRP Framework standards, focusing on Architectural correctness, clean code, and automated Validation Loops.
9
-
10
- ## ๐ŸŽฏ Scope of Work
11
- Apply this Skill when:
12
- - **Design**: Designing the API structure or Database Schema.
13
- - **Implementation**: Writing FastAPI code, Pydantic Models, or the Service Layer.
14
- - **Refactor**: Revamping legacy code for better organization or full Async compatibility.
15
- - **Workflow**: When engaging in tasks related to Backend APIs (spanning from planning to Verify).
16
-
17
- ---
18
-
19
- ## 1. ๐Ÿ” Platform & Stack Detection
20
- Always ascertain the environment prior to starting work:
21
- 1. **Indicators**: Locate `FastAPI` in `main.py`, `requirements.txt`, or through `@app.get()` decorators.
22
- 2. **Database/ORM**: Identify the utilization of `SQLAlchemy` (Async/Sync), `SQLModel`, or `Tortoise`.
23
- 3. **Pydantic**: Confirm whether Version 1.x or 2.x is used (to guarantee proper Syntax).
24
- 4. **Project Type**: Examine if the structure is Monolithic (Small) or Modular (Production-Ready).
25
-
26
- ---
27
-
28
- ## 2. ๐Ÿ—๏ธ Architecture & Organization
29
- Adhere to a Production-Ready architecture (strive to avoid files exceeding 500 lines):
30
-
31
- ```text
32
- app/
33
- โ”œโ”€โ”€ api/ # API route handlers
34
- โ”œโ”€โ”€ core/ # config, security, database setup
35
- โ”œโ”€โ”€ models/ # Database models (ORM)
36
- โ”œโ”€โ”€ schemas/ # Pydantic schemas (Request/Response)
37
- โ”œโ”€โ”€ services/ # Business logic layer
38
- โ”œโ”€โ”€ repositories/ # Data access layer (CRUD)
39
- โ”œโ”€โ”€ utils/ # Utility functions
40
- โ””โ”€โ”€ main.py # Application entry
41
- ```
42
-
43
- ### Naming Conventions
44
- - **Files**: `snake_case` (e.g., `auth_service.py`)
45
- - **Classes**: `PascalCase` (e.g., `UserUpdate`)
46
- - **Functions**: `snake_case` (e.g., `get_active_users`)
47
- - **Endpoints**: `kebab-case` (e.g., `/api/v1/user-profiles`)
48
-
49
- ---
50
-
51
- ## 3. ๐Ÿ›ก๏ธ Implementation Patterns (Best Practices)
52
-
53
- ### 3.1 Async All The Way
54
- - Employ `async def` consistently for Endpoints.
55
- - Utilize `await` for all I/O operations (Database, API Call, File System).
56
- - **Prohibited**: Using Blocking code inside an Async function (e.g., `time.sleep`, `requests.get`). Employ `asyncio.sleep` or `httpx` instead.
57
-
58
- ### 3.2 Dependency Injection (FastAPI `Depends`)
59
- Use `Depends` for managing Shared resources:
60
- ```python
61
- @router.post("/", response_model=Item)
62
- async def create_item(
63
- item_in: ItemCreate,
64
- db: AsyncSession = Depends(get_db),
65
- current_user: User = Depends(get_current_user)
66
- ):
67
- return await service.create(db, obj_in=item_in, user=current_user)
68
- ```
69
-
70
- ### 3.3 CRUD Repository Pattern
71
- Segregate Data management Logic from Business Logic:
72
- ```python
73
- # repositories/base.py
74
- class BaseRepository(Generic[ModelType, CreateSchema, UpdateSchema]):
75
- async def get(self, db: AsyncSession, id: Any) -> Optional[ModelType]:
76
- result = await db.execute(select(self.model).where(self.model.id == id))
77
- return result.scalars().first()
78
- ```
79
-
80
- ---
81
-
82
- ## 4. ๐Ÿ”„ PRP Workflow Integration (Pure Agentic)
83
- For each Task, the Agent must adhere to these principles:
84
-
85
- ### Phase: Planning (/30-Plan)
86
- - Designate the files to be created/modified in the `File & Directory Index`.
87
- - Formulate a comprehensive `Validation Loop`:
88
- - **Step 1**: Lint & Type Check (`ruff`, `mypy`)
89
- - **Step 2**: Unit Test (`pytest`)
90
- - **Step 3**: Integration Test (Start the server and `curl` or use `httpx`)
91
-
92
- ### Phase: Implement (/40-Implement)
93
- - Proceed with subtasks sequentially and update `implement.md` as the primary progress record.
94
- - When producing a new Endpoint, consistently generate the corresponding Pydantic Schema and Test simultaneously.
95
-
96
- ### Phase: Verify (/50-Verify)
97
- - Execute all commands outlined in the `Validation Loop`.
98
- - Should an Error emerge, the AI must diagnose and rectify it promptly (Fix-Forward).
99
-
100
- ---
101
-
102
- ## ๐Ÿงช Testing & Validation
103
- - **Framework**: Utilize `pytest` alongside `pytest-asyncio`.
104
- - **Mocking**: Adopt `unittest.mock` or `pytest-mock` for External services.
105
- - **Async Client**: Use `httpx.AsyncClient` to dispatch Requests to FastAPI.
106
- - **Evidence**: Document passed outcomes in `verify.md` as the primary verification record.
107
-
108
- ---
109
-
110
- ## โšก Quick Reference: Common Gotchas
111
- - **Pydantic v2**: Employ `model_dump()` instead of `dict()` and `model_validate()` rather than `from_orm()`.
112
- - **SQLAlchemy Async**: Necessitates the `postgresql+asyncpg://` schema and requires `await session.commit()`.
113
- - **FastAPI Middleware**: Be cautious regarding the insertion sequence of Middleware (CORS should commonly be near the end or customized based on Auth requirements).
114
- - **Token Efficiency**: Should a file grow excessively long, propose Module Splitting as early as the Planning phase.
@@ -1,36 +0,0 @@
1
- ---
2
- name: prp-dev-multiplatform
3
- description: Intelligent platform router for PRP development. Automatically detects whether the project is FastAPI, Odoo, or PHP and provides guidance on which specific skill to use.
4
- ---
5
-
6
- # ๐Ÿšฆ PRP Dev โ€“ Platform Router (Pure Agentic)
7
-
8
- This Skill functions as an **"Intelligent Receptionist"**, helping detect the technology powering your current project and directing other AIs (or myself) to adopt the appropriate specialized Skill for the job.
9
-
10
- ## ๐Ÿ” Platform Detection Logic
11
-
12
- When kick-starting a new task or if the environment is ambiguous, I will scan the files as follows:
13
-
14
- ### 1. ๐Ÿ FastAPI
15
- - **Check**: `main.py`, `app.py` featuring `from fastapi import FastAPI`, or a `requirements.txt` file listing `fastapi`.
16
- - **Recommended Skill**: `prp-dev-fastapi`
17
-
18
- ### 2. ๐Ÿ“ฆ Odoo (ERP)
19
- - **Check**: The `addons/` folder, `__manifest__.py` (for versions 13+), or `__openerp__.py` (for version 8).
20
- - **Recommended Skill**: `prp-dev-odoo`
21
-
22
- ### 3. ๐Ÿ˜ PHP (CI/Yii)
23
- - **Check**: The `application/` folder (CodeIgniter) or the `vendor/yiisoft/` folder (Yii).
24
- - **Recommended Skill**: `prp-dev-php`
25
-
26
- ---
27
-
28
- ## ๐Ÿ› ๏ธ Action Flow
29
-
30
- Upon detecting a Platform:
31
- 1. **Notification**: I will inform you of the detected Stack (e.g., "Detected: Odoo 13 module").
32
- 2. **Mode Switch**: I will instantly harness the knowledge from the relevant specialized Skill to plan (`/30-Plan`) and write code (`/40-Implement`).
33
- 3. **Fallback**: If an unrecognized Stack is spotted, I will ask you for details or default to the standard **Generic Python/JS** pattern.
34
-
35
- ---
36
- *Developed for Nexus-DevFlow โ€” Hybrid Development Support*