@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.
- package/package.json +1 -1
- package/template/.agents/skills/9arm-skills/README.md +3 -3
- package/template/.agents/skills/intelligent-routing/SKILL.md +1 -1
- package/template/.claude/skills/9arm-skills/README.md +3 -3
- package/template/.claude/skills/intelligent-routing/SKILL.md +1 -1
- package/template/.nexus/nexus-devflow.json +1 -1
- package/template/AGENTS.md +3 -3
- package/template/devflow/context/project_index.json +108 -0
- package/template/.agents/skills/check-for-updates/SKILL.md +0 -117
- package/template/.agents/skills/devflow-concept-intake/SKILL.md +0 -150
- package/template/.agents/skills/devflow-concept-intake/agents/openai.yaml +0 -4
- package/template/.agents/skills/devflow-concept-intake/references/adoption-proposal-template.md +0 -60
- package/template/.agents/skills/devflow-concept-intake/references/concept-report-template.md +0 -47
- package/template/.agents/skills/devflow-concept-intake/references/upstream-tracking-template.md +0 -51
- package/template/.agents/skills/devflow-wiki/SKILL.md +0 -75
- package/template/.agents/skills/english-to-thai-translator/SKILL.md +0 -125
- package/template/.agents/skills/obsidian-bases/SKILL.md +0 -506
- package/template/.agents/skills/obsidian-bases/references/FUNCTIONS_REFERENCE.md +0 -173
- package/template/.agents/skills/obsidian-cli/SKILL.md +0 -115
- package/template/.agents/skills/obsidian-clipper-template-creator/SKILL.md +0 -73
- package/template/.agents/skills/obsidian-clipper-template-creator/assets/clipping-template.json +0 -51
- package/template/.agents/skills/obsidian-clipper-template-creator/assets/recipe-template.json +0 -48
- package/template/.agents/skills/obsidian-clipper-template-creator/references/analysis-workflow.md +0 -79
- package/template/.agents/skills/obsidian-clipper-template-creator/references/bases-workflow.md +0 -44
- package/template/.agents/skills/obsidian-clipper-template-creator/references/filters.md +0 -51
- package/template/.agents/skills/obsidian-clipper-template-creator/references/json-schema.md +0 -77
- package/template/.agents/skills/obsidian-clipper-template-creator/references/logic.md +0 -67
- package/template/.agents/skills/obsidian-clipper-template-creator/references/variables.md +0 -64
- package/template/.agents/skills/obsidian-markdown/SKILL.md +0 -205
- package/template/.agents/skills/obsidian-markdown/references/CALLOUTS.md +0 -58
- package/template/.agents/skills/obsidian-markdown/references/EMBEDS.md +0 -63
- package/template/.agents/skills/obsidian-markdown/references/PROPERTIES.md +0 -61
- package/template/.agents/skills/prompt-addons/SKILL.md +0 -99
- package/template/.agents/skills/prp-dev-fastapi/SKILL.md +0 -114
- package/template/.agents/skills/prp-dev-multiplatform/SKILL.md +0 -36
- package/template/.agents/skills/prp-dev-odoo/SKILL.md +0 -71
- package/template/.agents/skills/prp-dev-php/SKILL.md +0 -63
- package/template/.agents/skills/prp-sa-ba/SKILL.md +0 -52
- package/template/.agents/skills/red-team-tactics/SKILL.md +0 -199
- package/template/.agents/skills/writing-great-skills/SKILL.md +0 -65
- package/template/.claude/skills/check-for-updates/SKILL.md +0 -117
- package/template/.claude/skills/devflow-concept-intake/SKILL.md +0 -150
- package/template/.claude/skills/devflow-concept-intake/agents/openai.yaml +0 -4
- package/template/.claude/skills/devflow-concept-intake/references/adoption-proposal-template.md +0 -60
- package/template/.claude/skills/devflow-concept-intake/references/concept-report-template.md +0 -47
- package/template/.claude/skills/devflow-concept-intake/references/upstream-tracking-template.md +0 -51
- package/template/.claude/skills/devflow-wiki/SKILL.md +0 -75
- package/template/.claude/skills/english-to-thai-translator/SKILL.md +0 -125
- package/template/.claude/skills/obsidian-bases/SKILL.md +0 -506
- package/template/.claude/skills/obsidian-bases/references/FUNCTIONS_REFERENCE.md +0 -173
- package/template/.claude/skills/obsidian-cli/SKILL.md +0 -115
- package/template/.claude/skills/obsidian-clipper-template-creator/SKILL.md +0 -73
- package/template/.claude/skills/obsidian-clipper-template-creator/assets/clipping-template.json +0 -51
- package/template/.claude/skills/obsidian-clipper-template-creator/assets/recipe-template.json +0 -48
- package/template/.claude/skills/obsidian-clipper-template-creator/references/analysis-workflow.md +0 -79
- package/template/.claude/skills/obsidian-clipper-template-creator/references/bases-workflow.md +0 -44
- package/template/.claude/skills/obsidian-clipper-template-creator/references/filters.md +0 -51
- package/template/.claude/skills/obsidian-clipper-template-creator/references/json-schema.md +0 -77
- package/template/.claude/skills/obsidian-clipper-template-creator/references/logic.md +0 -67
- package/template/.claude/skills/obsidian-clipper-template-creator/references/variables.md +0 -64
- package/template/.claude/skills/obsidian-markdown/SKILL.md +0 -205
- package/template/.claude/skills/obsidian-markdown/references/CALLOUTS.md +0 -58
- package/template/.claude/skills/obsidian-markdown/references/EMBEDS.md +0 -63
- package/template/.claude/skills/obsidian-markdown/references/PROPERTIES.md +0 -61
- package/template/.claude/skills/prompt-addons/SKILL.md +0 -99
- package/template/.claude/skills/prp-dev-fastapi/SKILL.md +0 -114
- package/template/.claude/skills/prp-dev-multiplatform/SKILL.md +0 -36
- package/template/.claude/skills/prp-dev-odoo/SKILL.md +0 -71
- package/template/.claude/skills/prp-dev-php/SKILL.md +0 -63
- package/template/.claude/skills/prp-sa-ba/SKILL.md +0 -52
- package/template/.claude/skills/red-team-tactics/SKILL.md +0 -199
- package/template/.claude/skills/writing-great-skills/SKILL.md +0 -65
package/package.json
CHANGED
|
@@ -34,10 +34,10 @@ This pack adapts the engineering discipline ideas from `9arm-skills` into the Ne
|
|
|
34
34
|
|
|
35
35
|
Keep Nexus-DevFlow output formats intact:
|
|
36
36
|
|
|
37
|
-
- Debug output still goes to
|
|
37
|
+
- Debug output still goes to `devflow/debug/rca-{slug}.md`.
|
|
38
38
|
- PR review output still uses the PR review report contract.
|
|
39
|
-
- Specialist reports still go to
|
|
40
|
-
- Lessons still go to
|
|
39
|
+
- Specialist reports still go to `devflow/reports/`.
|
|
40
|
+
- Lessons still go to `devflow/lessons.md` or task logs.
|
|
41
41
|
|
|
42
42
|
When a report uses this pack, include a short source discipline note:
|
|
43
43
|
|
|
@@ -80,7 +80,7 @@ Use these agent mappings when expert judgment is the best next step:
|
|
|
80
80
|
### Use a Timeline stage when:
|
|
81
81
|
|
|
82
82
|
- the request advances a task through its lifecycle
|
|
83
|
-
- the user needs an artifact in
|
|
83
|
+
- the user needs an artifact in `devflow`
|
|
84
84
|
- the next step should change stage ownership
|
|
85
85
|
|
|
86
86
|
### Use a public companion command when:
|
|
@@ -34,10 +34,10 @@ This pack adapts the engineering discipline ideas from `9arm-skills` into the Ne
|
|
|
34
34
|
|
|
35
35
|
Keep Nexus-DevFlow output formats intact:
|
|
36
36
|
|
|
37
|
-
- Debug output still goes to
|
|
37
|
+
- Debug output still goes to `devflow/debug/rca-{slug}.md`.
|
|
38
38
|
- PR review output still uses the PR review report contract.
|
|
39
|
-
- Specialist reports still go to
|
|
40
|
-
- Lessons still go to
|
|
39
|
+
- Specialist reports still go to `devflow/reports/`.
|
|
40
|
+
- Lessons still go to `devflow/lessons.md` or task logs.
|
|
41
41
|
|
|
42
42
|
When a report uses this pack, include a short source discipline note:
|
|
43
43
|
|
|
@@ -80,7 +80,7 @@ Use these agent mappings when expert judgment is the best next step:
|
|
|
80
80
|
### Use a Timeline stage when:
|
|
81
81
|
|
|
82
82
|
- the request advances a task through its lifecycle
|
|
83
|
-
- the user needs an artifact in
|
|
83
|
+
- the user needs an artifact in `devflow`
|
|
84
84
|
- the next step should change stage ownership
|
|
85
85
|
|
|
86
86
|
### Use a public companion command when:
|
package/template/AGENTS.md
CHANGED
|
@@ -22,8 +22,8 @@ Unused adapter families can be removed. Codex and Antigravity projects keep `.ag
|
|
|
22
22
|
```
|
|
23
23
|
|
|
24
24
|
### Mainline Stages:
|
|
25
|
-
1. `/00-Discover` - Explore a request before delivery commitment. Creates a Discovery ID (
|
|
26
|
-
2. `/10-Define` - Turn an approved discovery into one or more bounded delivery runs (
|
|
25
|
+
1. `/00-Discover` - Explore a request before delivery commitment. Creates a Discovery ID (`devflow/discoveries/...`).
|
|
26
|
+
2. `/10-Define` - Turn an approved discovery into one or more bounded delivery runs (`devflow/runs/{running-id}/10-define.md`).
|
|
27
27
|
3. `/20-Spec` - Formalize markdown-first specifications (`20-spec.md`).
|
|
28
28
|
4. `/30-Plan` - Transform spec into executable steps (`30-plan.md`).
|
|
29
29
|
5. `/40-Implement` - Execute planned tasks incrementally (`40-implement.md`).
|
|
@@ -39,7 +39,7 @@ Unused adapter families can be removed. Codex and Antigravity projects keep `.ag
|
|
|
39
39
|
- `PRD`: Product framing before delivery commitment
|
|
40
40
|
- `Issue-Triage`: Intaking and triaging incoming reports
|
|
41
41
|
- `Security-Review`: High-severity security review
|
|
42
|
-
- `Wiki`: Knowledge base management under
|
|
42
|
+
- `Wiki`: Knowledge base management under `devflow/wiki/`
|
|
43
43
|
- `Check-For-Updates`: Verify or upgrade DevFlow setup
|
|
44
44
|
- `Help`: Routing and process assistance
|
|
45
45
|
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
{
|
|
2
|
+
"project_root": "D:\\devtools\\nexus-devflow",
|
|
3
|
+
"project_type": "single",
|
|
4
|
+
"services": {
|
|
5
|
+
"prps_framework": {
|
|
6
|
+
"name": "prps_framework",
|
|
7
|
+
"path": "D:\\devtools\\nexus-devflow",
|
|
8
|
+
"language": "JavaScript and Python",
|
|
9
|
+
"framework": "PRPs Context Engineering Framework",
|
|
10
|
+
"type": "library",
|
|
11
|
+
"package_manager": "npm",
|
|
12
|
+
"entry_point": "package.json",
|
|
13
|
+
"key_directories": {
|
|
14
|
+
".agent": {
|
|
15
|
+
"path": ".agent",
|
|
16
|
+
"purpose": "Primary Antigravity IDE agent framework bundle"
|
|
17
|
+
},
|
|
18
|
+
"devflow": {
|
|
19
|
+
"path": "devflow",
|
|
20
|
+
"purpose": "Canonical workspace root for stage context, active runs, shared reports, and reference contracts"
|
|
21
|
+
},
|
|
22
|
+
"scripts": {
|
|
23
|
+
"path": "scripts",
|
|
24
|
+
"purpose": "Root npm automation scripts"
|
|
25
|
+
},
|
|
26
|
+
"docs": {
|
|
27
|
+
"path": "docs",
|
|
28
|
+
"purpose": "Human-readable user and maintainer guides"
|
|
29
|
+
}
|
|
30
|
+
},
|
|
31
|
+
"dependencies": [
|
|
32
|
+
"Node.js >=18.17",
|
|
33
|
+
"Python 3",
|
|
34
|
+
"Git",
|
|
35
|
+
"DevFlow-compatible agent adapters"
|
|
36
|
+
],
|
|
37
|
+
"dev_dependencies": [],
|
|
38
|
+
"testing": "npm run check",
|
|
39
|
+
"test_directory": "scripts",
|
|
40
|
+
"scripts": {
|
|
41
|
+
"check": "node ./scripts/check-devflow.mjs",
|
|
42
|
+
"check:static": "node ./scripts/validate-framework.mjs",
|
|
43
|
+
"sync:adapters": "node ./scripts/sync-adapters.js",
|
|
44
|
+
"test": "npm --prefix packages/create-nexus-devflow test",
|
|
45
|
+
"test:routing": "node ./scripts/evals/routing.js",
|
|
46
|
+
"test:package": "node ./scripts/smoke-package.mjs",
|
|
47
|
+
"activate": "node ./scripts/activate-agent.mjs",
|
|
48
|
+
"goal": "node ./scripts/goal-runner.mjs",
|
|
49
|
+
"graphify": "node ./scripts/graphify.mjs",
|
|
50
|
+
"graphify:install": "node ./scripts/graphify.mjs install --platform antigravity",
|
|
51
|
+
"graphify:update": "node ./scripts/graphify.mjs update .",
|
|
52
|
+
"graphify:hook:install": "node ./scripts/install-git-hook.mjs",
|
|
53
|
+
"index": "node ./scripts/generate-project-index.mjs",
|
|
54
|
+
"link-project": "node ./scripts/link-project.mjs",
|
|
55
|
+
"migrate:artifacts": "node ./scripts/migrate-stage-artifacts.mjs",
|
|
56
|
+
"render:html": "node ./scripts/render-html.mjs",
|
|
57
|
+
"render:html:test": "node ./scripts/test-render-html-core.mjs",
|
|
58
|
+
"report:html": "node ./scripts/generate-report-html.mjs",
|
|
59
|
+
"report:html:test": "node ./scripts/test-generate-report-html.mjs",
|
|
60
|
+
"artifact-language:switch": "node ./scripts/switch-artifact-language.mjs",
|
|
61
|
+
"artifact-language:test": "node ./scripts/test-switch-artifact-language.mjs",
|
|
62
|
+
"validate:manual-review:test": "node ./scripts/test-manual-review-contract.mjs",
|
|
63
|
+
"validate:stage-content:test": "node ./scripts/test-stage-content-contract.mjs",
|
|
64
|
+
"validate:run-status:test": "node ./scripts/test-summarize-run-status.mjs",
|
|
65
|
+
"validate:checklists:test": "node ./scripts/test-validate-checklists.mjs",
|
|
66
|
+
"validate:skills:test": "node ./scripts/test-skill-selection-policy.mjs",
|
|
67
|
+
"validate:verify-impact:test": "node ./scripts/test-verify-impact-contract.mjs",
|
|
68
|
+
"roadmap:validate": "node ./scripts/validate-framework.mjs --roadmap-only",
|
|
69
|
+
"security:scan": "node ./scripts/scan-security-hygiene.mjs",
|
|
70
|
+
"sync:check": "node ./scripts/sync-agent-bundle.mjs",
|
|
71
|
+
"ob-loop": "node ./scripts/ob-runner.mjs",
|
|
72
|
+
"validate": "node ./scripts/validate-framework.mjs",
|
|
73
|
+
"validate:all": "node ./scripts/validate-all.mjs",
|
|
74
|
+
"validate:docs": "node ./scripts/scan-doc-contract.mjs",
|
|
75
|
+
"codex:install-global": "node ./scripts/install-codex-global.mjs",
|
|
76
|
+
"codex:check-global": "node ./scripts/update-codex-global.mjs --check",
|
|
77
|
+
"codex:update-global": "node ./scripts/update-codex-global.mjs",
|
|
78
|
+
"codex:update-global:pull": "node ./scripts/update-codex-global.mjs --pull"
|
|
79
|
+
}
|
|
80
|
+
},
|
|
81
|
+
"agent_flow": {
|
|
82
|
+
"name": "agent_flow",
|
|
83
|
+
"path": "D:\\devtools\\nexus-devflow\\.agent",
|
|
84
|
+
"language": "JavaScript and Python",
|
|
85
|
+
"framework": "DevFlow 2.0 .agent bundle with stage-based markdown workflows",
|
|
86
|
+
"type": "library",
|
|
87
|
+
"package_manager": "npm",
|
|
88
|
+
"entry_point": "./workflows",
|
|
89
|
+
"key_directories": {},
|
|
90
|
+
"dependencies": [
|
|
91
|
+
"Node.js >=18.17"
|
|
92
|
+
],
|
|
93
|
+
"testing": "Node.js script tests and framework validation"
|
|
94
|
+
}
|
|
95
|
+
},
|
|
96
|
+
"infrastructure": {},
|
|
97
|
+
"conventions": {
|
|
98
|
+
"documentation": "Markdown",
|
|
99
|
+
"artifact_format": "Markdown-first",
|
|
100
|
+
"agent_bundle": ".agents",
|
|
101
|
+
"primary_ide": "Codex",
|
|
102
|
+
"workspace_directory": "devflow",
|
|
103
|
+
"package_manager": "npm",
|
|
104
|
+
"legacy_cursor_removed": true
|
|
105
|
+
},
|
|
106
|
+
"generated_by": "scripts/generate-project-index.mjs",
|
|
107
|
+
"created_at": "2026-08-16T19:13:33.317Z"
|
|
108
|
+
}
|
|
@@ -1,117 +0,0 @@
|
|
|
1
|
-
---name: check-for-updates
|
|
2
|
-
|
|
3
|
-
description: Install, upgrade, or verify Nexus-DevFlow setup for this machine or project using SETUP-BY-AI.md as the source of truth.
|
|
4
|
-
argument-hint: [optional: target project path, provider/tool, or update intent]
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Check For Updates
|
|
8
|
-
|
|
9
|
-
`Check-For-Updates` is a public companion command for Nexus-DevFlow install, upgrade, and setup verification work.
|
|
10
|
-
|
|
11
|
-
It is not a numbered mainline stage.
|
|
12
|
-
|
|
13
|
-
## Mission
|
|
14
|
-
|
|
15
|
-
Install or upgrade Nexus-DevFlow 2.0 for this machine or target project.
|
|
16
|
-
|
|
17
|
-
First read `SETUP-BY-AI.md` from the Nexus-DevFlow repository and use it as the operational source of truth.
|
|
18
|
-
|
|
19
|
-
Detect:
|
|
20
|
-
|
|
21
|
-
- framework root
|
|
22
|
-
- package version
|
|
23
|
-
- provider or tool
|
|
24
|
-
- target project
|
|
25
|
-
- whether the current setup is using `Codex global`, `Central clone + link`, or `Manual copy / overwrite`
|
|
26
|
-
|
|
27
|
-
Keep `.workspaces` project-local.
|
|
28
|
-
|
|
29
|
-
Do not overwrite user instruction files blindly.
|
|
30
|
-
|
|
31
|
-
After install or upgrade, run `roadmap:validate`, `validate`, and `validate:all` where relevant, then report files changed, installed version, framework root, chosen route, and any manual approval steps.
|
|
32
|
-
|
|
33
|
-
Repository reference:
|
|
34
|
-
|
|
35
|
-
```text
|
|
36
|
-
https://github.com/Jakkrich/nexus-devflow
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
## When To Use
|
|
40
|
-
|
|
41
|
-
Use this command when:
|
|
42
|
-
|
|
43
|
-
- the user wants to install Nexus-DevFlow into Codex or another AI tool
|
|
44
|
-
- the user wants to install Nexus-DevFlow into a target project
|
|
45
|
-
- the user wants to upgrade an existing Nexus-DevFlow install
|
|
46
|
-
- the user wants to check whether the current machine or project is on the expected framework version
|
|
47
|
-
- the user needs routing across optional Codex global setup, `Central clone + link`, or `Manual copy / overwrite`
|
|
48
|
-
|
|
49
|
-
## Operating Rules
|
|
50
|
-
|
|
51
|
-
- `SETUP-BY-AI.md` is the operational source of truth
|
|
52
|
-
- prefer the safest route that matches the user request and existing environment
|
|
53
|
-
- for project-local setup, prefer `Central clone + link`
|
|
54
|
-
- use `Manual copy / overwrite` only when linking is unsuitable or explicitly rejected
|
|
55
|
-
- treat `AI install` as guided execution of one of the supported routes, not as a separate bundle layout
|
|
56
|
-
- preserve user-authored instructions outside managed Nexus-DevFlow content
|
|
57
|
-
- do not link, copy, or share `.workspaces` from the framework repo into another project
|
|
58
|
-
- if the framework repo is dirty, do not pull automatically; report the dirty files and ask before proceeding with a pull-based update
|
|
59
|
-
- do not claim success until the relevant validation commands pass
|
|
60
|
-
|
|
61
|
-
## Execution Flow
|
|
62
|
-
|
|
63
|
-
1. Read `SETUP-BY-AI.md`.
|
|
64
|
-
2. Detect the framework root and confirm the framework files listed there exist.
|
|
65
|
-
3. Detect the installed or target version from `package.json`.
|
|
66
|
-
4. Detect the provider or tool context.
|
|
67
|
-
5. Detect the target project and keep its `.workspaces` local to that project.
|
|
68
|
-
6. Detect the current route already in use, if any:
|
|
69
|
-
- optional `Codex global`
|
|
70
|
-
- `Central clone + link`
|
|
71
|
-
- `Manual copy / overwrite`
|
|
72
|
-
7. Choose the route:
|
|
73
|
-
- optional `Codex global` only when explicitly requested
|
|
74
|
-
- `Central clone + link` for project-local setup by default
|
|
75
|
-
- `Manual copy / overwrite` only when linking is not suitable
|
|
76
|
-
8. If upgrading and the user wants latest, inspect git cleanliness before any pull-based update.
|
|
77
|
-
9. Apply the relevant install or upgrade commands.
|
|
78
|
-
10. Run validation:
|
|
79
|
-
- `npm.cmd run roadmap:validate`
|
|
80
|
-
- `npm.cmd run validate`
|
|
81
|
-
- `npm.cmd run validate:all`
|
|
82
|
-
- plus provider-specific checks such as `npm.cmd run codex:check-global` when applicable
|
|
83
|
-
11. Report the outcome in the final setup result format.
|
|
84
|
-
|
|
85
|
-
## Final Report Format
|
|
86
|
-
|
|
87
|
-
```text
|
|
88
|
-
Nexus-DevFlow setup result
|
|
89
|
-
- Mode:
|
|
90
|
-
- Framework root:
|
|
91
|
-
- Framework version:
|
|
92
|
-
- Target project:
|
|
93
|
-
- Provider:
|
|
94
|
-
- Files changed:
|
|
95
|
-
- Validation:
|
|
96
|
-
- Warnings or manual steps:
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
## Relationship To DevFlow 2.0
|
|
100
|
-
|
|
101
|
-
- Classification: Companion command
|
|
102
|
-
- Mainline status: Not a numbered stage
|
|
103
|
-
- Typical entry points: before using DevFlow on a new machine, before linking or copying into a target project, after pulling framework changes, or during provider setup maintenance
|
|
104
|
-
- Typical handoff targets: `Help`, `/00-Discover`, or the user's requested active task after setup is verified
|
|
105
|
-
|
|
106
|
-
## Sources
|
|
107
|
-
|
|
108
|
-
- `SETUP-BY-AI.md`
|
|
109
|
-
- `SETUP.md`
|
|
110
|
-
- `AGENTS.md`
|
|
111
|
-
- `package.json`
|
|
112
|
-
- `docs/install-update-troubleshooting.md`
|
|
113
|
-
|
|
114
|
-
## Next Workflow Recommendation
|
|
115
|
-
|
|
116
|
-
- Default: return to the user's requested work after setup is verified
|
|
117
|
-
- Common routes: `Help` for routing, `/00-Discover` for new work, or `/50-Verify` when setup validation exposes framework issues
|
|
@@ -1,150 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: devflow-concept-intake
|
|
3
|
-
description: Studies external Git repositories, READMEs, prompt frameworks, agent workflows, and engineering-methodology repos before adapting ideas into Nexus-DevFlow. Use when the user asks to research a repo for DevFlow, compare concepts, decide what to adopt or reject, create an adoption proposal, write an option guide for coupled practices, or track upstream sources for adopted concepts.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# DevFlow Concept Intake
|
|
7
|
-
|
|
8
|
-
## Overview
|
|
9
|
-
|
|
10
|
-
Use this skill to turn external repo ideas into deliberate Nexus-DevFlow decisions. Study the source, critique the principles, discuss trade-offs with the user, then propose adoption only when the concept improves the workflow without unnecessary complexity.
|
|
11
|
-
|
|
12
|
-
## Core Rule
|
|
13
|
-
|
|
14
|
-
Do not import ideas just because they are interesting. Every concept must pass through critique, DevFlow fit analysis, and user discussion before it becomes a workflow, agent, skill, artifact, or option guide.
|
|
15
|
-
|
|
16
|
-
## Core Process
|
|
17
|
-
|
|
18
|
-
### 1. Source Intake
|
|
19
|
-
|
|
20
|
-
Identify the source before judging it:
|
|
21
|
-
|
|
22
|
-
- Record repo URL, README path, docs path, branch, commit, tag, or release when available.
|
|
23
|
-
- Prefer primary source files: `README`, docs, examples, workflow definitions, prompts, CLI scripts, schemas, and changelog.
|
|
24
|
-
- If the user gives only a summary, mark source confidence as `low` and ask for the repo/README before making durable recommendations.
|
|
25
|
-
- Separate stated principles from inferred principles.
|
|
26
|
-
|
|
27
|
-
For current or remote source facts, browse or fetch the source when tools allow it. Do not rely on memory for live repo state.
|
|
28
|
-
|
|
29
|
-
### 2. Discussion-First Report
|
|
30
|
-
|
|
31
|
-
Produce a direct critique before proposing implementation. Use `references/concept-report-template.md` when a written artifact is requested or the analysis is substantial.
|
|
32
|
-
|
|
33
|
-
Classify each concept:
|
|
34
|
-
|
|
35
|
-
| Decision | Meaning |
|
|
36
|
-
| :--- | :--- |
|
|
37
|
-
| `Adopt` | Fits DevFlow as-is and adds clear value. |
|
|
38
|
-
| `Adapt` | Useful idea, but must be reshaped for DevFlow. |
|
|
39
|
-
| `Reject` | Does not fit, adds avoidable risk, or conflicts with DevFlow goals. |
|
|
40
|
-
| `Defer` | Potentially useful, but needs evidence, a real use case, or upstream maturity. |
|
|
41
|
-
|
|
42
|
-
Be explicit about what not to take. A rejected idea is useful output, not a failure.
|
|
43
|
-
|
|
44
|
-
### 3. Adoption Proposal
|
|
45
|
-
|
|
46
|
-
Only create an adoption proposal after the user agrees the concept is worth exploring. Use `references/adoption-proposal-template.md`.
|
|
47
|
-
|
|
48
|
-
Map the concept to the smallest fitting DevFlow surface:
|
|
49
|
-
|
|
50
|
-
| Target | Use When |
|
|
51
|
-
| :--- | :--- |
|
|
52
|
-
| Workflow | The idea changes phase order, gates, or user-visible commands. |
|
|
53
|
-
| Agent | The idea needs a specialist persona with a bounded responsibility. |
|
|
54
|
-
| Skill | The idea is reusable guidance or a discipline layer inside existing workflows. |
|
|
55
|
-
| Artifact | The idea needs persistent JSON or Markdown state. |
|
|
56
|
-
| Option guide | The idea is useful only as an optional bundle of practices. |
|
|
57
|
-
| Wiki/docs | The idea is knowledge, not behavior. |
|
|
58
|
-
|
|
59
|
-
Prefer skill-backed or option-guide adoption before adding new slash workflows. Keep the canonical `/00-Discover -> /10-Define -> /20-Spec -> /30-Plan -> /40-Implement -> /50-Verify -> /60-Report -> /70-Release` path stable unless the concept improves a core invariant.
|
|
60
|
-
|
|
61
|
-
### 4. Coupled Concepts And Option Packs
|
|
62
|
-
|
|
63
|
-
When principles must be used together, do not scatter them across unrelated flows. Write them as an option pack:
|
|
64
|
-
|
|
65
|
-
- Name the pack with the `devflow-*` prefix.
|
|
66
|
-
- State which concepts are mandatory together and which are optional.
|
|
67
|
-
- Define when to activate the pack.
|
|
68
|
-
- Define what workflows, agents, skills, artifacts, and validation gates are affected.
|
|
69
|
-
- Include an explicit "Do not use this option when..." section.
|
|
70
|
-
|
|
71
|
-
Examples:
|
|
72
|
-
|
|
73
|
-
- `devflow-upstream-sync-pack`: use only when adopting concepts that need regular upstream review.
|
|
74
|
-
- `devflow-agent-discipline-pack`: use when multiple agent behavior rules must work together.
|
|
75
|
-
- `devflow-research-to-adoption-pack`: use when repo study, proposal, and tracking must be chained.
|
|
76
|
-
|
|
77
|
-
### 5. Upstream Tracking
|
|
78
|
-
|
|
79
|
-
Track upstream only for concepts the user chooses to adopt or actively evaluate. Use `references/upstream-tracking-template.md`.
|
|
80
|
-
|
|
81
|
-
Record:
|
|
82
|
-
|
|
83
|
-
- Source repo and exact revision.
|
|
84
|
-
- Adopted concepts and local DevFlow mapping.
|
|
85
|
-
- Local files or workflows affected.
|
|
86
|
-
- Update strategy: manual review, scheduled review, diff-based review, or no tracking.
|
|
87
|
-
- Compatibility risk if upstream changes.
|
|
88
|
-
- Credit and license notes when applicable.
|
|
89
|
-
|
|
90
|
-
Do not promise automatic syncing unless the repository has a clear, testable transformation path. Prefer reviewable update notes over blind merges.
|
|
91
|
-
|
|
92
|
-
## Fit Criteria
|
|
93
|
-
|
|
94
|
-
Favor concepts that:
|
|
95
|
-
|
|
96
|
-
- Reduce ambiguity in agent work.
|
|
97
|
-
- Improve traceability, validation, or recovery.
|
|
98
|
-
- Strengthen user-controlled phase gates.
|
|
99
|
-
- Fit the markdown-first stage artifact contract.
|
|
100
|
-
- Can be explained as a small rule, skill, option, or workflow addition.
|
|
101
|
-
- Preserve source credit and make upstream drift visible.
|
|
102
|
-
|
|
103
|
-
Reject or defer concepts that:
|
|
104
|
-
|
|
105
|
-
- Add autonomous execution that skips human approval gates.
|
|
106
|
-
- Require copying large frameworks wholesale.
|
|
107
|
-
- Make core workflows harder to understand.
|
|
108
|
-
- Depend on brittle prompt magic with no observable artifact.
|
|
109
|
-
- Duplicate an existing DevFlow skill, agent, or workflow.
|
|
110
|
-
- Create tracking burden without clear recurring value.
|
|
111
|
-
|
|
112
|
-
## Output Expectations
|
|
113
|
-
|
|
114
|
-
For lightweight discussion, answer in Thai or the user's language with:
|
|
115
|
-
|
|
116
|
-
- Source studied.
|
|
117
|
-
- Main principles found.
|
|
118
|
-
- `Adopt / Adapt / Reject / Defer` table.
|
|
119
|
-
- Direct critique.
|
|
120
|
-
- Recommended next DevFlow action.
|
|
121
|
-
|
|
122
|
-
For substantial work, produce one or more Markdown artifacts under an appropriate workspace path such as:
|
|
123
|
-
|
|
124
|
-
```text
|
|
125
|
-
devflow/research/devflow-concepts/{source-slug}/concept-report.md
|
|
126
|
-
devflow/research/devflow-concepts/{source-slug}/adoption-proposal.md
|
|
127
|
-
devflow/research/devflow-concepts/{source-slug}/upstream-tracking.md
|
|
128
|
-
```
|
|
129
|
-
|
|
130
|
-
Ask before writing files unless the user explicitly requested artifacts.
|
|
131
|
-
|
|
132
|
-
## Red Flags
|
|
133
|
-
|
|
134
|
-
- Summarizing the repo without giving a recommendation.
|
|
135
|
-
- Treating upstream popularity as proof of DevFlow fit.
|
|
136
|
-
- Proposing a new workflow when a skill or option guide is enough.
|
|
137
|
-
- Omitting the "do not adopt" list.
|
|
138
|
-
- Tracking every studied repo instead of only adopted or actively evaluated concepts.
|
|
139
|
-
- Mixing source truth, interpretation, and local proposal in one undifferentiated document.
|
|
140
|
-
|
|
141
|
-
## Verification
|
|
142
|
-
|
|
143
|
-
Before finishing:
|
|
144
|
-
|
|
145
|
-
- Confirm the source and revision confidence.
|
|
146
|
-
- Confirm every major concept has `Adopt`, `Adapt`, `Reject`, or `Defer`.
|
|
147
|
-
- Confirm rejected concepts and reasons are included.
|
|
148
|
-
- Confirm any adoption proposal maps to a specific DevFlow surface.
|
|
149
|
-
- Confirm coupled concepts are represented as an option pack.
|
|
150
|
-
- Confirm upstream tracking exists only when adoption or active evaluation is chosen.
|
|
@@ -1,4 +0,0 @@
|
|
|
1
|
-
interface:
|
|
2
|
-
display_name: "DevFlow Concept Intake"
|
|
3
|
-
short_description: "Evaluate repo concepts for DevFlow adoption"
|
|
4
|
-
default_prompt: "Use $devflow-concept-intake to study this repo or README, critique the concepts, and propose whether Nexus-DevFlow should adopt, adapt, reject, or track them."
|
package/template/.agents/skills/devflow-concept-intake/references/adoption-proposal-template.md
DELETED
|
@@ -1,60 +0,0 @@
|
|
|
1
|
-
# Adoption Proposal Template
|
|
2
|
-
|
|
3
|
-
Use this template for phase 2 after the user agrees a concept is worth exploring.
|
|
4
|
-
|
|
5
|
-
```markdown
|
|
6
|
-
# DevFlow Adoption Proposal: {concept-name}
|
|
7
|
-
|
|
8
|
-
## Recommendation
|
|
9
|
-
|
|
10
|
-
Adopt | Adapt | Defer
|
|
11
|
-
|
|
12
|
-
## Why This Belongs In Nexus-DevFlow
|
|
13
|
-
|
|
14
|
-
Explain the value in terms of DevFlow goals: clearer agent behavior, safer workflow gates, better artifacts, stronger validation, or reusable knowledge.
|
|
15
|
-
|
|
16
|
-
## Target DevFlow Surface
|
|
17
|
-
|
|
18
|
-
| Surface | Change |
|
|
19
|
-
| :--- | :--- |
|
|
20
|
-
| Workflow | |
|
|
21
|
-
| Agent | |
|
|
22
|
-
| Skill | |
|
|
23
|
-
| Artifact | |
|
|
24
|
-
| Option guide | |
|
|
25
|
-
| Wiki/docs | |
|
|
26
|
-
|
|
27
|
-
## Smallest Useful Version
|
|
28
|
-
|
|
29
|
-
Describe the smallest change that proves the concept works inside DevFlow.
|
|
30
|
-
|
|
31
|
-
## What Changes
|
|
32
|
-
|
|
33
|
-
- Files or folders:
|
|
34
|
-
- Commands or workflows:
|
|
35
|
-
- Agent behavior:
|
|
36
|
-
- Artifacts:
|
|
37
|
-
- Validation:
|
|
38
|
-
|
|
39
|
-
## What Does Not Change
|
|
40
|
-
|
|
41
|
-
State core DevFlow behavior that must remain stable.
|
|
42
|
-
|
|
43
|
-
## Option Pack
|
|
44
|
-
|
|
45
|
-
Use this section only when concepts must be used together.
|
|
46
|
-
|
|
47
|
-
- Pack name:
|
|
48
|
-
- Required concepts:
|
|
49
|
-
- Optional concepts:
|
|
50
|
-
- Activation trigger:
|
|
51
|
-
- Do not use when:
|
|
52
|
-
|
|
53
|
-
## Risks And Rejection Criteria
|
|
54
|
-
|
|
55
|
-
List reasons to stop or roll back.
|
|
56
|
-
|
|
57
|
-
## Validation Plan
|
|
58
|
-
|
|
59
|
-
List exact checks, scripts, docs review, or test tasks needed before considering adoption complete.
|
|
60
|
-
```
|
package/template/.agents/skills/devflow-concept-intake/references/concept-report-template.md
DELETED
|
@@ -1,47 +0,0 @@
|
|
|
1
|
-
# Concept Report Template
|
|
2
|
-
|
|
3
|
-
Use this template for phase 1: discussion-first repo or README study.
|
|
4
|
-
|
|
5
|
-
```markdown
|
|
6
|
-
# Concept Report: {source-name}
|
|
7
|
-
|
|
8
|
-
## Source
|
|
9
|
-
|
|
10
|
-
- Repo or document:
|
|
11
|
-
- Revision, tag, branch, or date checked:
|
|
12
|
-
- Files read:
|
|
13
|
-
- Source confidence: high | medium | low
|
|
14
|
-
|
|
15
|
-
## What The Source Is Trying To Do
|
|
16
|
-
|
|
17
|
-
Summarize the source in plain language. Separate the project's stated goal from your inference.
|
|
18
|
-
|
|
19
|
-
## Principles Found
|
|
20
|
-
|
|
21
|
-
| Principle | Evidence | Interpretation |
|
|
22
|
-
| :--- | :--- | :--- |
|
|
23
|
-
| | | |
|
|
24
|
-
|
|
25
|
-
## Decision Matrix
|
|
26
|
-
|
|
27
|
-
| Concept | Decision | Why | DevFlow Fit |
|
|
28
|
-
| :--- | :--- | :--- | :--- |
|
|
29
|
-
| | Adopt | | |
|
|
30
|
-
| | Adapt | | |
|
|
31
|
-
| | Reject | | |
|
|
32
|
-
| | Defer | | |
|
|
33
|
-
|
|
34
|
-
## Direct Critique
|
|
35
|
-
|
|
36
|
-
State what is strong, what is weak, what is overbuilt, what is missing, and what should not be copied into Nexus-DevFlow.
|
|
37
|
-
|
|
38
|
-
## Discussion Questions
|
|
39
|
-
|
|
40
|
-
-
|
|
41
|
-
-
|
|
42
|
-
-
|
|
43
|
-
|
|
44
|
-
## Recommended Next Step
|
|
45
|
-
|
|
46
|
-
Choose one: stop, discuss, write adoption proposal, create option pack, or track upstream.
|
|
47
|
-
```
|
package/template/.agents/skills/devflow-concept-intake/references/upstream-tracking-template.md
DELETED
|
@@ -1,51 +0,0 @@
|
|
|
1
|
-
# Upstream Tracking Template
|
|
2
|
-
|
|
3
|
-
Use this template for phase 3 only after the user chooses to adopt or actively evaluate a source concept.
|
|
4
|
-
|
|
5
|
-
```markdown
|
|
6
|
-
# Upstream Tracking: {source-name}
|
|
7
|
-
|
|
8
|
-
## Source
|
|
9
|
-
|
|
10
|
-
- Repo:
|
|
11
|
-
- Upstream revision:
|
|
12
|
-
- License:
|
|
13
|
-
- Credit:
|
|
14
|
-
- Date recorded:
|
|
15
|
-
|
|
16
|
-
## Adopted Or Evaluated Concepts
|
|
17
|
-
|
|
18
|
-
| Source Concept | Local DevFlow Mapping | Status |
|
|
19
|
-
| :--- | :--- | :--- |
|
|
20
|
-
| | | adopted | evaluating | rejected |
|
|
21
|
-
|
|
22
|
-
## Local Integration Points
|
|
23
|
-
|
|
24
|
-
- Workflows:
|
|
25
|
-
- Agents:
|
|
26
|
-
- Skills:
|
|
27
|
-
- Artifacts:
|
|
28
|
-
- Docs/wiki:
|
|
29
|
-
- Scripts:
|
|
30
|
-
|
|
31
|
-
## Update Strategy
|
|
32
|
-
|
|
33
|
-
Choose one:
|
|
34
|
-
|
|
35
|
-
- Manual review: revisit only when user asks.
|
|
36
|
-
- Scheduled review: revisit on a calendar or release cadence.
|
|
37
|
-
- Diff-based review: compare upstream changes against recorded revision.
|
|
38
|
-
- No tracking: preserve credit, but do not follow upstream.
|
|
39
|
-
|
|
40
|
-
## Compatibility Notes
|
|
41
|
-
|
|
42
|
-
Explain what could break if upstream changes, and what local decisions intentionally diverge from upstream.
|
|
43
|
-
|
|
44
|
-
## Review Checklist
|
|
45
|
-
|
|
46
|
-
- [ ] Compare upstream README or docs against recorded revision.
|
|
47
|
-
- [ ] Check whether adopted concepts changed meaning.
|
|
48
|
-
- [ ] Check whether local DevFlow mapping is still valid.
|
|
49
|
-
- [ ] Update adoption proposal or option guide if needed.
|
|
50
|
-
- [ ] Preserve credit and license notes.
|
|
51
|
-
```
|