@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
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jakkrichm/create-nexus-devflow",
3
- "version": "2.0.1",
3
+ "version": "2.0.2",
4
4
  "description": "Install or update the agent-ready DevFlow 2.0 workflow layer into a scaffolded or existing project.",
5
5
  "license": "MIT",
6
6
  "author": "Jakkrich",
@@ -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 `.workspaces/debug/rca-{slug}.md`.
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 `.workspaces/reports/`.
40
- - Lessons still go to `.workspaces/lessons.md` or task logs.
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 `.workspaces`
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 `.workspaces/debug/rca-{slug}.md`.
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 `.workspaces/reports/`.
40
- - Lessons still go to `.workspaces/lessons.md` or task logs.
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 `.workspaces`
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:
@@ -2,7 +2,7 @@
2
2
  "schemaVersion": 1,
3
3
  "name": "nexus-devflow",
4
4
  "package": "@jakkrichm/create-nexus-devflow",
5
- "version": "2.0.1",
5
+ "version": "2.0.2",
6
6
  "repository": "https://github.com/Jakkrich/nexus-devflow",
7
7
  "artifactLanguage": "th",
8
8
  "adapters": [
@@ -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 (`.workspaces/discoveries/...`).
26
- 2. `/10-Define` - Turn an approved discovery into one or more bounded delivery runs (`.workspaces/specs/{running-id}/10-define.md`).
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 `.workspaces/wiki/`
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."
@@ -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
- ```
@@ -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
- ```
@@ -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
- ```