devhive 0.1.40__tar.gz → 0.1.43__tar.gz

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 (65) hide show
  1. {devhive-0.1.40 → devhive-0.1.43}/MANIFEST.in +2 -0
  2. {devhive-0.1.40/devhive.egg-info → devhive-0.1.43}/PKG-INFO +65 -4
  3. {devhive-0.1.40 → devhive-0.1.43}/README.md +61 -3
  4. {devhive-0.1.40 → devhive-0.1.43/devhive.egg-info}/PKG-INFO +65 -4
  5. {devhive-0.1.40 → devhive-0.1.43}/devhive.egg-info/SOURCES.txt +26 -21
  6. devhive-0.1.43/devhive.egg-info/requires.txt +4 -0
  7. devhive-0.1.43/devhive_cli/agents/devhive-pm.md +128 -0
  8. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/agents/devhive.md +37 -1
  9. devhive-0.1.43/devhive_cli/main.py +471 -0
  10. devhive-0.1.43/devhive_cli/plugins/devhive-skills-only.ts +54 -0
  11. devhive-0.1.43/devhive_cli/plugins/package.json +8 -0
  12. {devhive-0.1.40/devhive_cli/skills/devhive_analyzer → devhive-0.1.43/devhive_cli/skills/devhive-analyzer}/SKILL.md +4 -4
  13. {devhive-0.1.40/devhive_cli/skills/devhive_architect → devhive-0.1.43/devhive_cli/skills/devhive-architect}/SKILL.md +1 -1
  14. {devhive-0.1.40/devhive_cli/skills/devhive_auditor → devhive-0.1.43/devhive_cli/skills/devhive-auditor}/SKILL.md +1 -1
  15. {devhive-0.1.40/devhive_cli/skills/devhive_backender → devhive-0.1.43/devhive_cli/skills/devhive-backender}/SKILL.md +1 -1
  16. {devhive-0.1.40/devhive_cli/skills/devhive_dba → devhive-0.1.43/devhive_cli/skills/devhive-dba}/SKILL.md +1 -1
  17. {devhive-0.1.40/devhive_cli/skills/devhive_designer → devhive-0.1.43/devhive_cli/skills/devhive-designer}/SKILL.md +1 -1
  18. {devhive-0.1.40/devhive_cli/skills/devhive_devops → devhive-0.1.43/devhive_cli/skills/devhive-devops}/SKILL.md +1 -1
  19. {devhive-0.1.40/devhive_cli/skills/devhive_explorer → devhive-0.1.43/devhive_cli/skills/devhive-explorer}/SKILL.md +3 -3
  20. {devhive-0.1.40/devhive_cli/skills/devhive_frontender → devhive-0.1.43/devhive_cli/skills/devhive-frontender}/SKILL.md +2 -5
  21. {devhive-0.1.40/devhive_cli/skills/devhive_perf → devhive-0.1.43/devhive_cli/skills/devhive-perf}/SKILL.md +1 -1
  22. {devhive-0.1.40/devhive_cli/skills/devhive_prd → devhive-0.1.43/devhive_cli/skills/devhive-prd}/SKILL.md +1 -7
  23. {devhive-0.1.40/devhive_cli/skills/devhive_proposal → devhive-0.1.43/devhive_cli/skills/devhive-proposal}/SKILL.md +1 -1
  24. {devhive-0.1.40/devhive_cli/skills/devhive_qa → devhive-0.1.43/devhive_cli/skills/devhive-qa}/SKILL.md +1 -1
  25. {devhive-0.1.40/devhive_cli/skills/devhive_releaser → devhive-0.1.43/devhive_cli/skills/devhive-releaser}/SKILL.md +1 -1
  26. {devhive-0.1.40/devhive_cli/skills/devhive_sast → devhive-0.1.43/devhive_cli/skills/devhive-sast}/SKILL.md +1 -1
  27. {devhive-0.1.40/devhive_cli/skills/devhive_taskplanner → devhive-0.1.43/devhive_cli/skills/devhive-taskplanner}/SKILL.md +9 -9
  28. {devhive-0.1.40/devhive_cli/skills/devhive_techwriter → devhive-0.1.43/devhive_cli/skills/devhive-techwriter}/SKILL.md +1 -1
  29. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/templates/AGENTS.backend.md +4 -13
  30. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/templates/AGENTS.frontend.md +12 -21
  31. {devhive-0.1.40 → devhive-0.1.43}/setup.py +6 -1
  32. devhive-0.1.43/tests/test_install.py +176 -0
  33. devhive-0.1.43/tests/test_skill_policy.py +86 -0
  34. devhive-0.1.40/devhive.egg-info/requires.txt +0 -1
  35. devhive-0.1.40/devhive_cli/main.py +0 -276
  36. {devhive-0.1.40 → devhive-0.1.43}/LICENSE +0 -0
  37. {devhive-0.1.40 → devhive-0.1.43}/devhive.egg-info/dependency_links.txt +0 -0
  38. {devhive-0.1.40 → devhive-0.1.43}/devhive.egg-info/entry_points.txt +0 -0
  39. {devhive-0.1.40 → devhive-0.1.43}/devhive.egg-info/top_level.txt +0 -0
  40. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/__init__.py +0 -0
  41. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/community_skills/architecture-patterns/SKILL.md +0 -0
  42. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/community_skills/architecture-patterns/resources/implementation-playbook.md +0 -0
  43. {devhive-0.1.40/devhive_cli/community_skills/backend-arthitect → devhive-0.1.43/devhive_cli/community_skills/backend-architect}/SKILL.md +0 -0
  44. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/community_skills/backend-security-coder/SKILL.md +0 -0
  45. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/community_skills/docker-expert/SKILL.md +0 -0
  46. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/community_skills/frontend-design/SKILL.md +0 -0
  47. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/community_skills/frontend-developer/SKILL.md +0 -0
  48. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/SKILL.md +0 -0
  49. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/theme-showcase.pdf +0 -0
  50. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/arctic-frost.md +0 -0
  51. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/botanical-garden.md +0 -0
  52. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/desert-rose.md +0 -0
  53. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/forest-canopy.md +0 -0
  54. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/golden-hour.md +0 -0
  55. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/midnight-galaxy.md +0 -0
  56. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/modern-minimalist.md +0 -0
  57. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/ocean-depths.md +0 -0
  58. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/sunset-boulevard.md +0 -0
  59. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/tech-innovation.md +0 -0
  60. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/memory.py +0 -0
  61. {devhive-0.1.40/devhive_cli/skills/devhive_orchestrator → devhive-0.1.43/devhive_cli/skills/devhive-orchestrator}/SKILL.md +0 -0
  62. {devhive-0.1.40/devhive_cli/skills/devhive_reflection → devhive-0.1.43/devhive_cli/skills/devhive-reflection}/SKILL.md +0 -0
  63. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/skills/devhive_workflow.md +0 -0
  64. {devhive-0.1.40 → devhive-0.1.43}/devhive_cli/templates_backend.py +0 -0
  65. {devhive-0.1.40 → devhive-0.1.43}/setup.cfg +0 -0
@@ -2,4 +2,6 @@ recursive-include devhive_cli/skills *
2
2
  recursive-include devhive_cli/community_skills *
3
3
  recursive-include devhive_cli/templates *
4
4
  recursive-include devhive_cli/agents *
5
+ recursive-include devhive_cli/plugins *
6
+ include devhive_cli/plugins/package.json
5
7
 
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: devhive
3
- Version: 0.1.40
3
+ Version: 0.1.43
4
4
  Summary: CLI to manage DevHive skills and autonomous AI agents for OpenCode.
5
5
  Home-page: https://github.com/ramBlanco/devhive
6
6
  Author: ramBlanco
@@ -11,12 +11,15 @@ Requires-Python: >=3.7
11
11
  Description-Content-Type: text/markdown
12
12
  License-File: LICENSE
13
13
  Requires-Dist: click>=8.0.0
14
+ Provides-Extra: test
15
+ Requires-Dist: pytest>=7.0.0; extra == "test"
14
16
  Dynamic: author
15
17
  Dynamic: classifier
16
18
  Dynamic: description
17
19
  Dynamic: description-content-type
18
20
  Dynamic: home-page
19
21
  Dynamic: license-file
22
+ Dynamic: provides-extra
20
23
  Dynamic: requires-dist
21
24
  Dynamic: requires-python
22
25
  Dynamic: summary
@@ -51,6 +54,44 @@ DevHive is composed of specialized Agent Skills that work sequentially:
51
54
 
52
55
  All of this is managed by the **`devhive-orchestrator`** skill.
53
56
 
57
+ ## The Agents
58
+
59
+ DevHive ships with two OpenCode agents:
60
+
61
+ ### `@devhive` — The Software Engineer
62
+
63
+ Autonomous software development agent. Hardwired to immediately start the SDD pipeline.
64
+
65
+ ```
66
+ @devhive Build a script that converts CSV to JSON running on AWS Lambda.
67
+ ```
68
+
69
+ ### `@devhive-pm` — The Product Manager
70
+
71
+ Standalone product layer that sits **above** the SDD pipeline. It defines *what* to build and *why*, then hands off to `@devhive` for *how*.
72
+
73
+ ```
74
+ @devhive-pm We need a way for customers to track their support tickets.
75
+ ```
76
+
77
+ The PM agent loads the bundled `devhive-prd` and `devhive-explorer` skills and produces:
78
+
79
+ | Artifact | Contents |
80
+ | --- | --- |
81
+ | `docs/PRODUCT/product-vision.md` | Problem, audience, value proposition, principles, non-goals |
82
+ | `docs/PRODUCT/stakeholders.md` | Stakeholder map, influence/interest, engagement strategy |
83
+ | `docs/PRODUCT/metrics.md` | North Star metric, supporting KPIs, baselines and targets |
84
+ | `docs/PRODUCT/roadmap.md` | Now / Next / Later horizons with dependencies |
85
+ | `docs/PRODUCT/backlog.md` | Prioritized backlog (MoSCoW + RICE) with effort, value and risk |
86
+ | `docs/PRODUCT_REQUIREMENTS.md` | Master PRD (whole product) |
87
+ | `.devhive/specs/00-prd.md` | Feature PRD for the current cycle |
88
+
89
+ The PM agent never writes code. Its output ends with an explicit handoff command so the pipeline can pick up the work without re-discovery:
90
+
91
+ ```
92
+ @devhive Implement the feature described in .devhive/specs/00-prd.md (backlog item PM-001).
93
+ ```
94
+
54
95
  ## Installation
55
96
 
56
97
  DevHive is available as a Python package via PyPI. You can install it globally to manage your OpenCode skills across all your environments.
@@ -62,10 +103,10 @@ pip install devhive
62
103
  Once installed, you can use the CLI to setup or update your DevHive environment:
63
104
 
64
105
  ```bash
65
- # Install all official and community skills into OpenCode
106
+ # Install DevHive's bundled skills and agents into OpenCode
66
107
  devhive install
67
108
 
68
- # Update your existing skills to the latest versions
109
+ # Update DevHive's bundled skills and agents to the latest versions
69
110
  devhive update-skill
70
111
 
71
112
  # Initialize a modern Next.js/React frontend AI guidelines file in your current project
@@ -75,6 +116,26 @@ devhive init-frontend
75
116
  devhive init-backend
76
117
  ```
77
118
 
119
+ DevHive installs only the skills bundled inside this package. It does not download, search for, or install third-party skills from GitHub or other external sources.
120
+
121
+ The install and update commands also remove the previously installed external `shadcn` and `prd` skills, stale DevHive skill directories, remote skill URLs from the OpenCode configuration, and the obsolete DevHive plugin dependency. Other project-local skills under `.opencode/skills`, `.claude/skills`, `.agents/skills`, and `skills/` are preserved.
122
+
123
+ DevHive writes OpenCode 2 configuration under `agents.<agent>.permissions` and preserves unrelated user configuration. Only the `devhive` and `devhive-pm` agents receive the strict DevHive skill allowlist; other agents keep their existing permissions. The bundled `devhive-skills-only` plugin keeps DevHive's bundled skills, OpenCode built-ins, and project-local skills available while removing external skills from the skill catalog.
124
+
125
+ ### Requirements
126
+
127
+ - Python 3.7 or newer
128
+ - OpenCode 2 (the bundled `devhive-skills-only` plugin uses the OpenCode 2 skill-transform API)
129
+
130
+ ### Tests
131
+
132
+ Install the test dependencies and run the test suite:
133
+
134
+ ```bash
135
+ pip install -e ".[test]"
136
+ pytest
137
+ ```
138
+
78
139
  ## Usage (The `@devhive` Agent)
79
140
 
80
141
  Instead of using OpenCode as a general assistant, invoke the dedicated `@devhive` agent. This agent is hardwired to immediately start the SDD pipeline.
@@ -102,7 +163,7 @@ touch .devhive/continuous
102
163
 
103
164
  - **Zero Setup**: No Python servers, no MCP configuration, no background processes.
104
165
  - **Local Memory**: The entire state of the project is readable by humans in `.devhive/specs/`. You can edit `02-proposal.md` manually, and the Architect will adapt to your changes.
105
- - **Modular**: Need a different architectural approach? You can just tweak the prompt inside `skills/devhive_architect/SKILL.md`.
166
+ - **Modular**: Need a different architectural approach? You can just tweak the prompt inside `skills/devhive-architect/SKILL.md`.
106
167
 
107
168
  ## License
108
169
 
@@ -28,6 +28,44 @@ DevHive is composed of specialized Agent Skills that work sequentially:
28
28
 
29
29
  All of this is managed by the **`devhive-orchestrator`** skill.
30
30
 
31
+ ## The Agents
32
+
33
+ DevHive ships with two OpenCode agents:
34
+
35
+ ### `@devhive` — The Software Engineer
36
+
37
+ Autonomous software development agent. Hardwired to immediately start the SDD pipeline.
38
+
39
+ ```
40
+ @devhive Build a script that converts CSV to JSON running on AWS Lambda.
41
+ ```
42
+
43
+ ### `@devhive-pm` — The Product Manager
44
+
45
+ Standalone product layer that sits **above** the SDD pipeline. It defines *what* to build and *why*, then hands off to `@devhive` for *how*.
46
+
47
+ ```
48
+ @devhive-pm We need a way for customers to track their support tickets.
49
+ ```
50
+
51
+ The PM agent loads the bundled `devhive-prd` and `devhive-explorer` skills and produces:
52
+
53
+ | Artifact | Contents |
54
+ | --- | --- |
55
+ | `docs/PRODUCT/product-vision.md` | Problem, audience, value proposition, principles, non-goals |
56
+ | `docs/PRODUCT/stakeholders.md` | Stakeholder map, influence/interest, engagement strategy |
57
+ | `docs/PRODUCT/metrics.md` | North Star metric, supporting KPIs, baselines and targets |
58
+ | `docs/PRODUCT/roadmap.md` | Now / Next / Later horizons with dependencies |
59
+ | `docs/PRODUCT/backlog.md` | Prioritized backlog (MoSCoW + RICE) with effort, value and risk |
60
+ | `docs/PRODUCT_REQUIREMENTS.md` | Master PRD (whole product) |
61
+ | `.devhive/specs/00-prd.md` | Feature PRD for the current cycle |
62
+
63
+ The PM agent never writes code. Its output ends with an explicit handoff command so the pipeline can pick up the work without re-discovery:
64
+
65
+ ```
66
+ @devhive Implement the feature described in .devhive/specs/00-prd.md (backlog item PM-001).
67
+ ```
68
+
31
69
  ## Installation
32
70
 
33
71
  DevHive is available as a Python package via PyPI. You can install it globally to manage your OpenCode skills across all your environments.
@@ -39,10 +77,10 @@ pip install devhive
39
77
  Once installed, you can use the CLI to setup or update your DevHive environment:
40
78
 
41
79
  ```bash
42
- # Install all official and community skills into OpenCode
80
+ # Install DevHive's bundled skills and agents into OpenCode
43
81
  devhive install
44
82
 
45
- # Update your existing skills to the latest versions
83
+ # Update DevHive's bundled skills and agents to the latest versions
46
84
  devhive update-skill
47
85
 
48
86
  # Initialize a modern Next.js/React frontend AI guidelines file in your current project
@@ -52,6 +90,26 @@ devhive init-frontend
52
90
  devhive init-backend
53
91
  ```
54
92
 
93
+ DevHive installs only the skills bundled inside this package. It does not download, search for, or install third-party skills from GitHub or other external sources.
94
+
95
+ The install and update commands also remove the previously installed external `shadcn` and `prd` skills, stale DevHive skill directories, remote skill URLs from the OpenCode configuration, and the obsolete DevHive plugin dependency. Other project-local skills under `.opencode/skills`, `.claude/skills`, `.agents/skills`, and `skills/` are preserved.
96
+
97
+ DevHive writes OpenCode 2 configuration under `agents.<agent>.permissions` and preserves unrelated user configuration. Only the `devhive` and `devhive-pm` agents receive the strict DevHive skill allowlist; other agents keep their existing permissions. The bundled `devhive-skills-only` plugin keeps DevHive's bundled skills, OpenCode built-ins, and project-local skills available while removing external skills from the skill catalog.
98
+
99
+ ### Requirements
100
+
101
+ - Python 3.7 or newer
102
+ - OpenCode 2 (the bundled `devhive-skills-only` plugin uses the OpenCode 2 skill-transform API)
103
+
104
+ ### Tests
105
+
106
+ Install the test dependencies and run the test suite:
107
+
108
+ ```bash
109
+ pip install -e ".[test]"
110
+ pytest
111
+ ```
112
+
55
113
  ## Usage (The `@devhive` Agent)
56
114
 
57
115
  Instead of using OpenCode as a general assistant, invoke the dedicated `@devhive` agent. This agent is hardwired to immediately start the SDD pipeline.
@@ -79,7 +137,7 @@ touch .devhive/continuous
79
137
 
80
138
  - **Zero Setup**: No Python servers, no MCP configuration, no background processes.
81
139
  - **Local Memory**: The entire state of the project is readable by humans in `.devhive/specs/`. You can edit `02-proposal.md` manually, and the Architect will adapt to your changes.
82
- - **Modular**: Need a different architectural approach? You can just tweak the prompt inside `skills/devhive_architect/SKILL.md`.
140
+ - **Modular**: Need a different architectural approach? You can just tweak the prompt inside `skills/devhive-architect/SKILL.md`.
83
141
 
84
142
  ## License
85
143
 
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: devhive
3
- Version: 0.1.40
3
+ Version: 0.1.43
4
4
  Summary: CLI to manage DevHive skills and autonomous AI agents for OpenCode.
5
5
  Home-page: https://github.com/ramBlanco/devhive
6
6
  Author: ramBlanco
@@ -11,12 +11,15 @@ Requires-Python: >=3.7
11
11
  Description-Content-Type: text/markdown
12
12
  License-File: LICENSE
13
13
  Requires-Dist: click>=8.0.0
14
+ Provides-Extra: test
15
+ Requires-Dist: pytest>=7.0.0; extra == "test"
14
16
  Dynamic: author
15
17
  Dynamic: classifier
16
18
  Dynamic: description
17
19
  Dynamic: description-content-type
18
20
  Dynamic: home-page
19
21
  Dynamic: license-file
22
+ Dynamic: provides-extra
20
23
  Dynamic: requires-dist
21
24
  Dynamic: requires-python
22
25
  Dynamic: summary
@@ -51,6 +54,44 @@ DevHive is composed of specialized Agent Skills that work sequentially:
51
54
 
52
55
  All of this is managed by the **`devhive-orchestrator`** skill.
53
56
 
57
+ ## The Agents
58
+
59
+ DevHive ships with two OpenCode agents:
60
+
61
+ ### `@devhive` — The Software Engineer
62
+
63
+ Autonomous software development agent. Hardwired to immediately start the SDD pipeline.
64
+
65
+ ```
66
+ @devhive Build a script that converts CSV to JSON running on AWS Lambda.
67
+ ```
68
+
69
+ ### `@devhive-pm` — The Product Manager
70
+
71
+ Standalone product layer that sits **above** the SDD pipeline. It defines *what* to build and *why*, then hands off to `@devhive` for *how*.
72
+
73
+ ```
74
+ @devhive-pm We need a way for customers to track their support tickets.
75
+ ```
76
+
77
+ The PM agent loads the bundled `devhive-prd` and `devhive-explorer` skills and produces:
78
+
79
+ | Artifact | Contents |
80
+ | --- | --- |
81
+ | `docs/PRODUCT/product-vision.md` | Problem, audience, value proposition, principles, non-goals |
82
+ | `docs/PRODUCT/stakeholders.md` | Stakeholder map, influence/interest, engagement strategy |
83
+ | `docs/PRODUCT/metrics.md` | North Star metric, supporting KPIs, baselines and targets |
84
+ | `docs/PRODUCT/roadmap.md` | Now / Next / Later horizons with dependencies |
85
+ | `docs/PRODUCT/backlog.md` | Prioritized backlog (MoSCoW + RICE) with effort, value and risk |
86
+ | `docs/PRODUCT_REQUIREMENTS.md` | Master PRD (whole product) |
87
+ | `.devhive/specs/00-prd.md` | Feature PRD for the current cycle |
88
+
89
+ The PM agent never writes code. Its output ends with an explicit handoff command so the pipeline can pick up the work without re-discovery:
90
+
91
+ ```
92
+ @devhive Implement the feature described in .devhive/specs/00-prd.md (backlog item PM-001).
93
+ ```
94
+
54
95
  ## Installation
55
96
 
56
97
  DevHive is available as a Python package via PyPI. You can install it globally to manage your OpenCode skills across all your environments.
@@ -62,10 +103,10 @@ pip install devhive
62
103
  Once installed, you can use the CLI to setup or update your DevHive environment:
63
104
 
64
105
  ```bash
65
- # Install all official and community skills into OpenCode
106
+ # Install DevHive's bundled skills and agents into OpenCode
66
107
  devhive install
67
108
 
68
- # Update your existing skills to the latest versions
109
+ # Update DevHive's bundled skills and agents to the latest versions
69
110
  devhive update-skill
70
111
 
71
112
  # Initialize a modern Next.js/React frontend AI guidelines file in your current project
@@ -75,6 +116,26 @@ devhive init-frontend
75
116
  devhive init-backend
76
117
  ```
77
118
 
119
+ DevHive installs only the skills bundled inside this package. It does not download, search for, or install third-party skills from GitHub or other external sources.
120
+
121
+ The install and update commands also remove the previously installed external `shadcn` and `prd` skills, stale DevHive skill directories, remote skill URLs from the OpenCode configuration, and the obsolete DevHive plugin dependency. Other project-local skills under `.opencode/skills`, `.claude/skills`, `.agents/skills`, and `skills/` are preserved.
122
+
123
+ DevHive writes OpenCode 2 configuration under `agents.<agent>.permissions` and preserves unrelated user configuration. Only the `devhive` and `devhive-pm` agents receive the strict DevHive skill allowlist; other agents keep their existing permissions. The bundled `devhive-skills-only` plugin keeps DevHive's bundled skills, OpenCode built-ins, and project-local skills available while removing external skills from the skill catalog.
124
+
125
+ ### Requirements
126
+
127
+ - Python 3.7 or newer
128
+ - OpenCode 2 (the bundled `devhive-skills-only` plugin uses the OpenCode 2 skill-transform API)
129
+
130
+ ### Tests
131
+
132
+ Install the test dependencies and run the test suite:
133
+
134
+ ```bash
135
+ pip install -e ".[test]"
136
+ pytest
137
+ ```
138
+
78
139
  ## Usage (The `@devhive` Agent)
79
140
 
80
141
  Instead of using OpenCode as a general assistant, invoke the dedicated `@devhive` agent. This agent is hardwired to immediately start the SDD pipeline.
@@ -102,7 +163,7 @@ touch .devhive/continuous
102
163
 
103
164
  - **Zero Setup**: No Python servers, no MCP configuration, no background processes.
104
165
  - **Local Memory**: The entire state of the project is readable by humans in `.devhive/specs/`. You can edit `02-proposal.md` manually, and the Architect will adapt to your changes.
105
- - **Modular**: Need a different architectural approach? You can just tweak the prompt inside `skills/devhive_architect/SKILL.md`.
166
+ - **Modular**: Need a different architectural approach? You can just tweak the prompt inside `skills/devhive-architect/SKILL.md`.
106
167
 
107
168
  ## License
108
169
 
@@ -12,10 +12,11 @@ devhive_cli/__init__.py
12
12
  devhive_cli/main.py
13
13
  devhive_cli/memory.py
14
14
  devhive_cli/templates_backend.py
15
+ devhive_cli/agents/devhive-pm.md
15
16
  devhive_cli/agents/devhive.md
16
17
  devhive_cli/community_skills/architecture-patterns/SKILL.md
17
18
  devhive_cli/community_skills/architecture-patterns/resources/implementation-playbook.md
18
- devhive_cli/community_skills/backend-arthitect/SKILL.md
19
+ devhive_cli/community_skills/backend-architect/SKILL.md
19
20
  devhive_cli/community_skills/backend-security-coder/SKILL.md
20
21
  devhive_cli/community_skills/docker-expert/SKILL.md
21
22
  devhive_cli/community_skills/frontend-design/SKILL.md
@@ -32,25 +33,29 @@ devhive_cli/community_skills/theme-factory/themes/modern-minimalist.md
32
33
  devhive_cli/community_skills/theme-factory/themes/ocean-depths.md
33
34
  devhive_cli/community_skills/theme-factory/themes/sunset-boulevard.md
34
35
  devhive_cli/community_skills/theme-factory/themes/tech-innovation.md
36
+ devhive_cli/plugins/devhive-skills-only.ts
37
+ devhive_cli/plugins/package.json
35
38
  devhive_cli/skills/devhive_workflow.md
36
- devhive_cli/skills/devhive_analyzer/SKILL.md
37
- devhive_cli/skills/devhive_architect/SKILL.md
38
- devhive_cli/skills/devhive_auditor/SKILL.md
39
- devhive_cli/skills/devhive_backender/SKILL.md
40
- devhive_cli/skills/devhive_dba/SKILL.md
41
- devhive_cli/skills/devhive_designer/SKILL.md
42
- devhive_cli/skills/devhive_devops/SKILL.md
43
- devhive_cli/skills/devhive_explorer/SKILL.md
44
- devhive_cli/skills/devhive_frontender/SKILL.md
45
- devhive_cli/skills/devhive_orchestrator/SKILL.md
46
- devhive_cli/skills/devhive_perf/SKILL.md
47
- devhive_cli/skills/devhive_prd/SKILL.md
48
- devhive_cli/skills/devhive_proposal/SKILL.md
49
- devhive_cli/skills/devhive_qa/SKILL.md
50
- devhive_cli/skills/devhive_reflection/SKILL.md
51
- devhive_cli/skills/devhive_releaser/SKILL.md
52
- devhive_cli/skills/devhive_sast/SKILL.md
53
- devhive_cli/skills/devhive_taskplanner/SKILL.md
54
- devhive_cli/skills/devhive_techwriter/SKILL.md
39
+ devhive_cli/skills/devhive-analyzer/SKILL.md
40
+ devhive_cli/skills/devhive-architect/SKILL.md
41
+ devhive_cli/skills/devhive-auditor/SKILL.md
42
+ devhive_cli/skills/devhive-backender/SKILL.md
43
+ devhive_cli/skills/devhive-dba/SKILL.md
44
+ devhive_cli/skills/devhive-designer/SKILL.md
45
+ devhive_cli/skills/devhive-devops/SKILL.md
46
+ devhive_cli/skills/devhive-explorer/SKILL.md
47
+ devhive_cli/skills/devhive-frontender/SKILL.md
48
+ devhive_cli/skills/devhive-orchestrator/SKILL.md
49
+ devhive_cli/skills/devhive-perf/SKILL.md
50
+ devhive_cli/skills/devhive-prd/SKILL.md
51
+ devhive_cli/skills/devhive-proposal/SKILL.md
52
+ devhive_cli/skills/devhive-qa/SKILL.md
53
+ devhive_cli/skills/devhive-reflection/SKILL.md
54
+ devhive_cli/skills/devhive-releaser/SKILL.md
55
+ devhive_cli/skills/devhive-sast/SKILL.md
56
+ devhive_cli/skills/devhive-taskplanner/SKILL.md
57
+ devhive_cli/skills/devhive-techwriter/SKILL.md
55
58
  devhive_cli/templates/AGENTS.backend.md
56
- devhive_cli/templates/AGENTS.frontend.md
59
+ devhive_cli/templates/AGENTS.frontend.md
60
+ tests/test_install.py
61
+ tests/test_skill_policy.py
@@ -0,0 +1,4 @@
1
+ click>=8.0.0
2
+
3
+ [test]
4
+ pytest>=7.0.0
@@ -0,0 +1,128 @@
1
+ ---
2
+ description: Product Manager agent for discovery, PRDs, backlog prioritization, roadmap, and stakeholder alignment.
3
+ permissions:
4
+ - action: skill
5
+ resource: "*"
6
+ effect: deny
7
+ - action: skill
8
+ resource: "devhive-*"
9
+ effect: allow
10
+ - action: skill
11
+ resource: opencode
12
+ effect: allow
13
+ - action: skill
14
+ resource: report
15
+ effect: allow
16
+ - action: skill
17
+ resource: customize-opencode
18
+ effect: allow
19
+ ---
20
+
21
+ # DevHive PM Agent
22
+
23
+ You are DevHive PM, a senior Product Manager. You translate raw business ideas and user needs into precise, actionable product artifacts: vision, roadmap, prioritized backlog, and formal PRDs.
24
+
25
+ You operate as the **product layer above the DevHive SDD pipeline**. You do not design architectures, write code, or implement features. You define *what* to build and *why*, and hand off to the `@devhive` agent (or the `devhive-orchestrator` skill) for *how*.
26
+
27
+ ## Core Directive: Immediate Skill Loading (CRITICAL)
28
+
29
+ You are NOT a general conversational assistant. Your primary function is to produce product artifacts.
30
+
31
+ Whenever invoked, your FIRST action MUST be to use the `skill` tool to load these DevHive skills, in this order:
32
+
33
+ 1. `devhive-prd` — DevHive's Hybrid PRD approach (Master PRD + Feature PRD) and its exact output contract.
34
+ 2. `devhive-explorer` — requirement analysis, tech-stack awareness, and risk identification during discovery.
35
+
36
+ Only skills bundled with DevHive may be loaded. Do not install, download, or depend on external skills.
37
+
38
+ **Graceful degradation (MANDATORY):** If loading a DevHive skill returns an error because it is not installed on this machine, IGNORE the error and continue using your best judgment. Never fail the run over a missing optional skill.
39
+
40
+ **Partial-skill rule (MANDATORY):** Use these skills for their *methodology*, not blindly for their *output contract*. When a skill's own playbook mandates an artifact that this agent's Scope Rules forbid (for example, `devhive-explorer` mandates writing `.devhive/specs/01-exploration.md` and creating a root `GUIDELINES.md`), DO NOT create that artifact. Apply the skill's *thinking* (analysis depth, risk identification, stack awareness) and fold the findings into the artifacts this agent owns.
41
+
42
+ This agent's Scope Rules take precedence over any skill's output contract. Ask clarifying questions only when the answer would materially change the artifact — and never re-ask something the user already answered.
43
+
44
+ ## Operating Protocol
45
+
46
+ ### Step 1 — Discovery
47
+
48
+ Understand the request before writing anything. Use `read`, `glob` and `grep` to inspect the workspace:
49
+ - Existing `docs/PRODUCT/` artifacts — if present, read them first and UPDATE them instead of recreating them. Do not discard prior product decisions.
50
+ - `docs/PRODUCT_REQUIREMENTS.md` — the Master PRD, if it exists.
51
+ - `.devhive/specs/00-prd.md` — an existing Feature PRD for this cycle, if present.
52
+ - `README.md`, `AGENTS.md`, `GUIDELINES.md`, and the codebase entry points — to understand what already exists.
53
+
54
+ Ask **clarifying questions only when a decision would materially change the artifact** (target audience, core problem, scope boundary, success criteria). Group them into a single batch. If the user has already provided the answer, do not ask again.
55
+
56
+ ### Step 2 — Product Vision
57
+
58
+ Create or update `docs/PRODUCT/product-vision.md`:
59
+ - Problem being solved and who experiences it
60
+ - Target audience segments and their jobs-to-be-done
61
+ - Value proposition and differentiators
62
+ - Product principles (3-5 guiding rules used to arbitrate trade-offs)
63
+ - Explicit non-goals
64
+
65
+ ### Step 3 — Stakeholders & Metrics
66
+
67
+ Create or update `docs/PRODUCT/stakeholders.md`:
68
+ - Stakeholder table: name/role, interest, influence (high/low), needs, and how they are engaged
69
+
70
+ Create or update `docs/PRODUCT/metrics.md`:
71
+ - North Star metric with a baseline and a target
72
+ - Supporting metrics (acquisition, activation, retention, revenue, or the closest fit)
73
+ - Instrumentation gaps — what data is not yet collected
74
+ - Review cadence
75
+
76
+ ### Step 4 — Feature PRD (Hybrid PRD)
77
+
78
+ Follow the `devhive-prd` skill exactly. It writes:
79
+ - `docs/PRODUCT_REQUIREMENTS.md` — Master PRD (create it via reverse engineering if missing, update it with the new feature summary)
80
+ - `.devhive/specs/00-prd.md` — Feature PRD for the current cycle, using the six-section structure: Problem Statement, Target Audience, Goals & Success Metrics, Non-Goals, User Experience & Flows, Acceptance Criteria
81
+
82
+ ### Step 5 — Roadmap & Backlog
83
+
84
+ Create or update `docs/PRODUCT/roadmap.md`:
85
+ - Now / Next / Later horizons, each item with its user-facing outcome and dependencies
86
+ - Explicitly mark items that are candidates for the SDD pipeline
87
+
88
+ Create or update `docs/PRODUCT/backlog.md`:
89
+ - One row per item: `ID | Title | Description | MoSCoW | Reach | Impact | Confidence | Effort | RICE | Risk | Status`
90
+ - MoSCoW: `Must have` / `Should have` / `Could have` / `Won't have (this iteration)`
91
+ - RICE = (Reach × Impact × Confidence) / Effort. Use this fixed scale and state it in the file:
92
+ - **Reach**: affected users per month (absolute count)
93
+ - **Impact**: 3 = massive, 2 = high, 1 = medium, 0.5 = low, 0.25 = minimal
94
+ - **Confidence**: 100% = high, 80% = medium, 50% = low
95
+ - **Effort**: person-months
96
+ - Show the Reach, Impact, Confidence and Effort inputs as their own columns so any reviewer can recompute the RICE value. **Every published RICE score MUST equal the formula applied to the published inputs** — if they disagree, fix the score, never the formula.
97
+ - When no usage baseline exists, state that Reach is an estimate and lower Confidence accordingly; do not present estimates as measured data.
98
+ - Sorted by priority (Must haves first, then descending RICE within each tier)
99
+ - Link each `Must have` to the feature PRD in `.devhive/specs/00-prd.md`
100
+
101
+ ### Step 6 — Handoff to the SDD Pipeline
102
+
103
+ End with an explicit handoff block so the pipeline can pick up the work without re-discovery. State:
104
+ - The artifact paths produced (all `docs/PRODUCT/*` files plus `docs/PRODUCT_REQUIREMENTS.md` and `.devhive/specs/00-prd.md`)
105
+ - The single `Must have` item recommended for this cycle
106
+ - The exact command to hand off, e.g.:
107
+
108
+ ```
109
+ @devhive Implement the feature described in .devhive/specs/00-prd.md (backlog item PM-001).
110
+ ```
111
+
112
+ ## Scope Rules (STRICT)
113
+
114
+ 1. **No implementation.** You MUST NOT write source code, migrations, API routes, components, configs, or tests. You produce documents only.
115
+ 2. **No architecture decisions.** Technical design belongs to `devhive-architect`. You may note constraints and non-functional requirements, but you do not choose frameworks, schemas, or service boundaries.
116
+ 3. **Do not skip the PRD contract.** The `devhive-prd` output format for `docs/PRODUCT_REQUIREMENTS.md` and `.devhive/specs/00-prd.md` is a hard contract with the `devhive-orchestrator` skill. Never rename or relocate those two files.
117
+ 4. **Respect existing decisions.** When `docs/PRODUCT/` artifacts already exist, update them incrementally and preserve prior decisions unless the user explicitly overrides them.
118
+ 5. **No scope creep.** Anything not requested goes to `Won't have (this iteration)` in the backlog, not into the current scope.
119
+
120
+ ## Continuity
121
+
122
+ If the project has a `.devhive/memory/` directory, read `.devhive/memory/index.json` and `.devhive/memory/semantic.md` before writing. Respect any recorded product constraints (e.g., a rule like "never plan payments without PCI review"). Prioritize memories with score >= 0.7.
123
+
124
+ ## Tone & Behavior
125
+
126
+ Be extremely concise. Avoid conversational filler (e.g., "Sure, I can help with that!"). Output minimal prose to the user — focus on tool calls and artifact creation. Present decisions as short, decisive statements with rationale, and surface open questions explicitly rather than burying them.
127
+
128
+ Your success depends on loading the PRD and exploration skills, producing complete and internally consistent product artifacts, and handing off cleanly to the DevHive SDD pipeline.
@@ -1,6 +1,42 @@
1
1
  ---
2
- name: devhive
3
2
  description: Autonomous Software Development Agent using Skill-Driven Development (SDD).
3
+ permissions:
4
+ - action: skill
5
+ resource: "*"
6
+ effect: deny
7
+ - action: skill
8
+ resource: "devhive-*"
9
+ effect: allow
10
+ - action: skill
11
+ resource: architecture-patterns
12
+ effect: allow
13
+ - action: skill
14
+ resource: backend-architect
15
+ effect: allow
16
+ - action: skill
17
+ resource: backend-security-coder
18
+ effect: allow
19
+ - action: skill
20
+ resource: docker-expert
21
+ effect: allow
22
+ - action: skill
23
+ resource: frontend-design
24
+ effect: allow
25
+ - action: skill
26
+ resource: frontend-developer
27
+ effect: allow
28
+ - action: skill
29
+ resource: theme-factory
30
+ effect: allow
31
+ - action: skill
32
+ resource: opencode
33
+ effect: allow
34
+ - action: skill
35
+ resource: report
36
+ effect: allow
37
+ - action: skill
38
+ resource: customize-opencode
39
+ effect: allow
4
40
  ---
5
41
 
6
42
  # DevHive Agent