devhive 0.1.38__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.
- {devhive-0.1.38 → devhive-0.1.43}/MANIFEST.in +2 -0
- {devhive-0.1.38/devhive.egg-info → devhive-0.1.43}/PKG-INFO +65 -4
- {devhive-0.1.38 → devhive-0.1.43}/README.md +61 -3
- {devhive-0.1.38 → devhive-0.1.43/devhive.egg-info}/PKG-INFO +65 -4
- {devhive-0.1.38 → devhive-0.1.43}/devhive.egg-info/SOURCES.txt +27 -20
- devhive-0.1.43/devhive.egg-info/requires.txt +4 -0
- devhive-0.1.43/devhive_cli/agents/devhive-pm.md +128 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/agents/devhive.md +37 -1
- devhive-0.1.43/devhive_cli/main.py +471 -0
- devhive-0.1.43/devhive_cli/memory.py +358 -0
- devhive-0.1.43/devhive_cli/plugins/devhive-skills-only.ts +54 -0
- devhive-0.1.43/devhive_cli/plugins/package.json +8 -0
- devhive-0.1.43/devhive_cli/skills/devhive-analyzer/SKILL.md +151 -0
- {devhive-0.1.38/devhive_cli/skills/devhive_architect → devhive-0.1.43/devhive_cli/skills/devhive-architect}/SKILL.md +10 -2
- {devhive-0.1.38/devhive_cli/skills/devhive_auditor → devhive-0.1.43/devhive_cli/skills/devhive-auditor}/SKILL.md +10 -2
- {devhive-0.1.38/devhive_cli/skills/devhive_backender → devhive-0.1.43/devhive_cli/skills/devhive-backender}/SKILL.md +10 -2
- {devhive-0.1.38/devhive_cli/skills/devhive_dba → devhive-0.1.43/devhive_cli/skills/devhive-dba}/SKILL.md +1 -1
- {devhive-0.1.38/devhive_cli/skills/devhive_designer → devhive-0.1.43/devhive_cli/skills/devhive-designer}/SKILL.md +1 -1
- {devhive-0.1.38/devhive_cli/skills/devhive_devops → devhive-0.1.43/devhive_cli/skills/devhive-devops}/SKILL.md +1 -1
- {devhive-0.1.38/devhive_cli/skills/devhive_explorer → devhive-0.1.43/devhive_cli/skills/devhive-explorer}/SKILL.md +11 -4
- {devhive-0.1.38/devhive_cli/skills/devhive_frontender → devhive-0.1.43/devhive_cli/skills/devhive-frontender}/SKILL.md +11 -6
- {devhive-0.1.38/devhive_cli/skills/devhive_orchestrator → devhive-0.1.43/devhive_cli/skills/devhive-orchestrator}/SKILL.md +22 -18
- {devhive-0.1.38/devhive_cli/skills/devhive_perf → devhive-0.1.43/devhive_cli/skills/devhive-perf}/SKILL.md +1 -1
- {devhive-0.1.38/devhive_cli/skills/devhive_prd → devhive-0.1.43/devhive_cli/skills/devhive-prd}/SKILL.md +1 -7
- {devhive-0.1.38/devhive_cli/skills/devhive_proposal → devhive-0.1.43/devhive_cli/skills/devhive-proposal}/SKILL.md +1 -1
- {devhive-0.1.38/devhive_cli/skills/devhive_qa → devhive-0.1.43/devhive_cli/skills/devhive-qa}/SKILL.md +1 -1
- devhive-0.1.43/devhive_cli/skills/devhive-reflection/SKILL.md +91 -0
- {devhive-0.1.38/devhive_cli/skills/devhive_releaser → devhive-0.1.43/devhive_cli/skills/devhive-releaser}/SKILL.md +1 -1
- {devhive-0.1.38/devhive_cli/skills/devhive_sast → devhive-0.1.43/devhive_cli/skills/devhive-sast}/SKILL.md +1 -1
- {devhive-0.1.38/devhive_cli/skills/devhive_taskplanner → devhive-0.1.43/devhive_cli/skills/devhive-taskplanner}/SKILL.md +17 -10
- {devhive-0.1.38/devhive_cli/skills/devhive_techwriter → devhive-0.1.43/devhive_cli/skills/devhive-techwriter}/SKILL.md +1 -1
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/templates/AGENTS.backend.md +4 -13
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/templates/AGENTS.frontend.md +12 -21
- {devhive-0.1.38 → devhive-0.1.43}/setup.py +6 -1
- devhive-0.1.43/tests/test_install.py +176 -0
- devhive-0.1.43/tests/test_skill_policy.py +86 -0
- devhive-0.1.38/devhive.egg-info/requires.txt +0 -1
- devhive-0.1.38/devhive_cli/main.py +0 -194
- devhive-0.1.38/devhive_cli/skills/devhive_reflection/SKILL.md +0 -37
- {devhive-0.1.38 → devhive-0.1.43}/LICENSE +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive.egg-info/dependency_links.txt +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive.egg-info/entry_points.txt +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive.egg-info/top_level.txt +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/__init__.py +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/community_skills/architecture-patterns/SKILL.md +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/community_skills/architecture-patterns/resources/implementation-playbook.md +0 -0
- {devhive-0.1.38/devhive_cli/community_skills/backend-arthitect → devhive-0.1.43/devhive_cli/community_skills/backend-architect}/SKILL.md +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/community_skills/backend-security-coder/SKILL.md +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/community_skills/docker-expert/SKILL.md +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/community_skills/frontend-design/SKILL.md +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/community_skills/frontend-developer/SKILL.md +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/SKILL.md +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/theme-showcase.pdf +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/arctic-frost.md +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/botanical-garden.md +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/desert-rose.md +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/forest-canopy.md +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/golden-hour.md +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/midnight-galaxy.md +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/modern-minimalist.md +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/ocean-depths.md +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/sunset-boulevard.md +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/community_skills/theme-factory/themes/tech-innovation.md +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/skills/devhive_workflow.md +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/devhive_cli/templates_backend.py +0 -0
- {devhive-0.1.38 → devhive-0.1.43}/setup.cfg +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: devhive
|
|
3
|
-
Version: 0.1.
|
|
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
|
|
106
|
+
# Install DevHive's bundled skills and agents into OpenCode
|
|
66
107
|
devhive install
|
|
67
108
|
|
|
68
|
-
# Update
|
|
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/
|
|
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
|
|
80
|
+
# Install DevHive's bundled skills and agents into OpenCode
|
|
43
81
|
devhive install
|
|
44
82
|
|
|
45
|
-
# Update
|
|
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/
|
|
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.
|
|
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
|
|
106
|
+
# Install DevHive's bundled skills and agents into OpenCode
|
|
66
107
|
devhive install
|
|
67
108
|
|
|
68
|
-
# Update
|
|
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/
|
|
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
|
|
|
@@ -10,11 +10,13 @@ devhive.egg-info/requires.txt
|
|
|
10
10
|
devhive.egg-info/top_level.txt
|
|
11
11
|
devhive_cli/__init__.py
|
|
12
12
|
devhive_cli/main.py
|
|
13
|
+
devhive_cli/memory.py
|
|
13
14
|
devhive_cli/templates_backend.py
|
|
15
|
+
devhive_cli/agents/devhive-pm.md
|
|
14
16
|
devhive_cli/agents/devhive.md
|
|
15
17
|
devhive_cli/community_skills/architecture-patterns/SKILL.md
|
|
16
18
|
devhive_cli/community_skills/architecture-patterns/resources/implementation-playbook.md
|
|
17
|
-
devhive_cli/community_skills/backend-
|
|
19
|
+
devhive_cli/community_skills/backend-architect/SKILL.md
|
|
18
20
|
devhive_cli/community_skills/backend-security-coder/SKILL.md
|
|
19
21
|
devhive_cli/community_skills/docker-expert/SKILL.md
|
|
20
22
|
devhive_cli/community_skills/frontend-design/SKILL.md
|
|
@@ -31,24 +33,29 @@ devhive_cli/community_skills/theme-factory/themes/modern-minimalist.md
|
|
|
31
33
|
devhive_cli/community_skills/theme-factory/themes/ocean-depths.md
|
|
32
34
|
devhive_cli/community_skills/theme-factory/themes/sunset-boulevard.md
|
|
33
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
|
|
34
38
|
devhive_cli/skills/devhive_workflow.md
|
|
35
|
-
devhive_cli/skills/
|
|
36
|
-
devhive_cli/skills/
|
|
37
|
-
devhive_cli/skills/
|
|
38
|
-
devhive_cli/skills/
|
|
39
|
-
devhive_cli/skills/
|
|
40
|
-
devhive_cli/skills/
|
|
41
|
-
devhive_cli/skills/
|
|
42
|
-
devhive_cli/skills/
|
|
43
|
-
devhive_cli/skills/
|
|
44
|
-
devhive_cli/skills/
|
|
45
|
-
devhive_cli/skills/
|
|
46
|
-
devhive_cli/skills/
|
|
47
|
-
devhive_cli/skills/
|
|
48
|
-
devhive_cli/skills/
|
|
49
|
-
devhive_cli/skills/
|
|
50
|
-
devhive_cli/skills/
|
|
51
|
-
devhive_cli/skills/
|
|
52
|
-
devhive_cli/skills/
|
|
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
|
|
53
58
|
devhive_cli/templates/AGENTS.backend.md
|
|
54
|
-
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,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
|