Skip to content

feat: v3 restructuring — simplified 6-step workflow with 3 roles#48

Merged
nullhack merged 7 commits intomainfrom
v3
Apr 14, 2026
Merged

feat: v3 restructuring — simplified 6-step workflow with 3 roles#48
nullhack merged 7 commits intomainfrom
v3

Conversation

@nullhack
Copy link
Copy Markdown
Owner

Summary

  • Simplify the development workflow from 8-phase/6-role to 6-step/3-role (Product Owner, Developer, Reviewer)
  • Replace architect, manager, repo-manager, requirements-gatherer, overseer agents with lean product-owner and reviewer agents
  • Reduce skills from 17 to 9, eliminating duplication and overengineering
  • Add unified documentation site (landing page + API + coverage + tests) published via ghp-import

Type of Change

  • 🚀 New feature
  • 🔧 Refactoring
  • 📚 Documentation update
  • 🔨 Build/CI changes

Changes Made

  • Replace 5 agents (architect, manager, repo-manager, requirements-gatherer, overseer) with product-owner and reviewer
  • Rewrite developer agent: owns architecture, TDD, implementation, release (Steps 2-4+6)
  • Rewrite scope, verify, session-workflow, tdd, implementation, code-quality, pr-management, git-release, create-skill skills
  • Remove 11 skills (architectural-analysis, delegation-coordination, epic-workflow, feature-definition, qa-enforcement, requirements-management, signature-design, workflow-coordination, prototype-script, create-agent, reference/)
  • Replace split docs/features/{business,architecture}/ with flat docs/features/{backlog,in-progress,completed}/ (WIP=1 enforced by filesystem)
  • Delete pingpong/ untracked code and all ping pong feature docs
  • Remove setup_project.py and .opencode/templates/ — setup-project agent does setup directly
  • Fix pyproject.toml: remove wrong dotenv dep, remove mutmut, reduce markers from 11 to 3 (unit/integration/slow), simplify task commands
  • Add ghp-import for doc publishing; doc-build now generates API + coverage + test reports; docs/index.html landing page
  • Fix .gitignore to track docs/index.html and docs/features/ while ignoring generated outputs
  • Update CI workflow to use uv run task <name> cleanly
  • Add ruff-format-check task for CI format checking

Testing

Replace the 8-phase, 6-agent, 16-skill framework with a leaner
3-role (PO/Developer/Reviewer), 6-step, Kanban WIP=1 workflow.

- Consolidate agents: drop architect, manager, overseer, repo-manager,
  requirements-gatherer; add product-owner and reviewer
- Replace 12 overlapping skills with scope and verify; rewrite all
  remaining skills to match new workflow
- Merge business+architecture feature docs into one file per feature
  under docs/features/{backlog,in-progress,completed}/
- Simplify test markers to 3 (unit, integration, slow); remove mutmut
- Add timeout 10s guard on task run in all agent/skill instructions
- Fix test mark (system -> integration), remove type: ignore, fix
  render_collapsed deprecation warning
- Simplify CI task invocations to use uv run task <name>
…en setup

Delete the 429-line setup script and 3 template files that drifted from
the real project files. Replace with a concise setup-project agent that
applies changes directly to the source files using concrete bash commands.

- Delete setup_project.py, .opencode/templates/ (3 files)
- Rewrite setup-project.md with step-by-step instructions covering all
  9 files that need changes (pyproject.toml, README, main.py, source,
  tests, CI, Dockerfile, docker-compose, git remote)
- No more template drift — setup works on the actual project files
- Add docs/index.html landing page linking to API, coverage, and test reports
- Replace bloated inline Python doc-publish with ghp-import one-liner
- doc-build now generates all three outputs (pdoc + pytest-cov + pytest-html)
- Add ghp-import to dev dependencies
- Fix .gitignore to track docs/index.html and docs/features/ while ignoring generated outputs
- Add docs/features/{backlog,in-progress,completed}/ directory structure
@nullhack nullhack merged commit 43f8f94 into main Apr 14, 2026
8 checks passed
@nullhack nullhack deleted the v3 branch April 14, 2026 10:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant