Skip to content

refactor(workflow): migrate to YAML flow definitions and knowledge system#124

Merged
nullhack merged 2 commits intomainfrom
refactor/flow-yaml-knowledge-system
Apr 26, 2026
Merged

refactor(workflow): migrate to YAML flow definitions and knowledge system#124
nullhack merged 2 commits intomainfrom
refactor/flow-yaml-knowledge-system

Conversation

@nullhack
Copy link
Copy Markdown
Owner

Summary

  • Replace static FLOW.md/WORK.md markdown with YAML flow definitions in docs/flows/ and session state tracking in .flowception/
  • Extract inline knowledge from all skills into a wikilink-based knowledge system under .opencode/knowledge/
  • Add create-knowledge skill for knowledge file management
  • Add flow YAML definitions: feature-flow, scope-cycle, arch-cycle, tdd-cycle
  • Add scripts/check_knowledge.py for knowledge file validation
  • Add docs/assets/workflow.svg visual asset
  • Update all skills to reference knowledge via [[wikilinks]] instead of duplicating inline content
  • Simplify FLOW.md and WORK.md to redirect pointers

Key Changes

Area Before After
Workflow state machine FLOW.md (279 lines) docs/flows/*.yaml (4 YAML files)
Session tracking WORK.md (flat markdown) .flowception/session-*.yaml
Knowledge Embedded in skills .opencode/knowledge/ wikilink system
Agent references WORK.md @state .flowception/ session files

Testing

  • Lint: uv run task lint
  • Type check: uv run task static-check
  • Tests: uv run task test
  • Knowledge validation: python scripts/check_knowledge.py

…stem

- Replace static FLOW.md/WORK.md with YAML flow definitions in docs/flows/
- Add .flowception/ for session state tracking (gitignored)
- Extract knowledge from skills into .opencode/knowledge/ wikilink system
- Add create-knowledge skill for knowledge management
- Add docs/flows/ with feature-flow, scope-cycle, arch-cycle, tdd-cycle YAMLs
- Add scripts/check_knowledge.py for knowledge validation
- Add docs/assets/workflow.svg visual asset
- Update all skills to reference knowledge via wikilinks instead of inline content
- Update AGENTS.md to reflect new workflow structure
- Simplify FLOW.md and WORK.md to redirects
- Add version, exits, attrs to all flow YAML files
- Remove type field (subflow implied by flow: presence)
- Remove state-level requires/params/agent (moved to when/attrs)
- Move agent assignments to flow-level attrs.agents mapping
- Add flow-version constraints to subflow references
- Convert requires (state-level) to when (transition-level) guards
- Update flow skill to v3.0 with v1 format rules
- Update state-machine knowledge with v1 spec
@nullhack nullhack merged commit 16b82dd into main Apr 26, 2026
8 of 9 checks passed
@nullhack nullhack deleted the refactor/flow-yaml-knowledge-system branch April 26, 2026 13:09
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