Skip to content

notque/vexjoy-agent / skills/process/workflow

workflow

Verified

Structured work: multi-phase tasks, feature builds, planning, objective loops, hill climbing.

FileKindSize
SKILL.mdskill md13.2 KB
references/adr-template.mdmarkdown9.4 KB
references/agent-upgrade.mdmarkdown12.5 KB
references/article-evaluation-pipeline.mdmarkdown8.9 KB
references/article-evaluation-pipeline/references/report-template.mdmarkdown2.5 KB
references/article-evaluation-pipeline/references/wabi-sabi-classification.mdmarkdown2.4 KB
references/auto-pipeline.mdmarkdown12.5 KB
references/auto-pipeline/references/pipeline-catalog.jsonconfig15.0 KB
references/auto-pipeline/references/pipeline-catalog.mdmarkdown4.3 KB
references/build_dag.pyscript12.5 KB
references/chain-composer.mdmarkdown20.4 KB
references/chain-composer/references/canonical-chains.mdmarkdown13.9 KB
references/comprehensive-review-workflow.jsscript19.3 KB
references/comprehensive-review.mdmarkdown27.8 KB
references/comprehensive-review/references/output-templates.mdmarkdown10.6 KB
references/comprehensive-review/references/wave-0-per-package.mdmarkdown5.6 KB
references/comprehensive-review/references/wave-1-foundation.mdmarkdown10.4 KB
references/comprehensive-review/references/wave-2-deep-dive.mdmarkdown7.3 KB
references/comprehensive-review/references/wave-3-adversarial.mdmarkdown7.4 KB
references/dag-compatibility-matrix.mdmarkdown13.0 KB
references/dag-composition-patterns.mdmarkdown5.0 KB
references/dag-orchestration-advanced.mdmarkdown6.3 KB
references/dag-orchestration-examples.mdmarkdown11.4 KB
references/dag-skill-patterns.mdmarkdown12.5 KB
references/de-ai-pipeline.jsscript14.6 KB
references/de-ai-pipeline.mdmarkdown6.3 KB
references/discover_skills.pyscript12.1 KB
references/do-perspectives.mdmarkdown11.5 KB
references/doc-pipeline.mdmarkdown9.2 KB
references/domain-research.mdmarkdown32.8 KB
references/domain-research/references/task-type-guide.mdmarkdown11.4 KB
references/explore-pipeline.jsscript18.6 KB
references/explore-pipeline.mdmarkdown15.0 KB
references/fan-out-workflow.jsscript9.7 KB
references/fan-out-workflow.pyscript10.4 KB
references/feedback-loop-construction.mdmarkdown14.3 KB
references/fl-design.mdmarkdown9.6 KB
references/fl-error-handling.mdmarkdown8.5 KB
references/fl-implement.mdmarkdown7.6 KB
references/fl-pipeline.mdmarkdown6.0 KB
references/fl-plan.mdmarkdown11.0 KB
references/fl-release.mdmarkdown3.8 KB
references/fl-shared.mdmarkdown3.6 KB
references/fl-validate.mdmarkdown4.5 KB
references/github-profile-rules.mdmarkdown10.5 KB
references/github-profile-rules/references/rule-categories.mdmarkdown6.5 KB
references/hc-SPEC.mdmarkdown3.3 KB
references/hc-domain-playbooks.mdmarkdown15.4 KB
references/hc-ledger.mdmarkdown3.3 KB
references/hc-profiling-tools.mdmarkdown3.7 KB
references/hill-climb.mdmarkdown9.3 KB
references/hook-development-pipeline.mdmarkdown12.9 KB
references/mcp-pipeline-builder.mdmarkdown16.3 KB
references/mcp-pipeline-builder/references/analysis-checklist.mdmarkdown6.2 KB
references/mcp-pipeline-builder/references/design-rules.mdmarkdown7.1 KB
references/mcp-pipeline-builder/references/evaluation-guide.mdmarkdown7.6 KB
references/mcp-pipeline-builder/references/python-scaffold-template.mdmarkdown9.5 KB
references/mcp-pipeline-builder/references/ts-scaffold-template.mdmarkdown1.6 KB
references/mcp-pipeline-builder/scripts/assemble-scaffold.pyscript6.3 KB
references/mcp-pipeline-builder/scripts/register_mcp.pyscript6.9 KB
references/mcp-pipeline-builder/templates/client-cli.ts.tmplother682 B
references/mcp-pipeline-builder/templates/client-http.ts.tmplother1.4 KB
references/mcp-pipeline-builder/templates/index.ts.tmplother1.1 KB
references/mcp-pipeline-builder/templates/package.json.tmplother477 B
references/mcp-pipeline-builder/templates/readme.md.tmplother1.1 KB
references/mcp-pipeline-builder/templates/tools.ts.tmplother3.0 KB
references/mcp-pipeline-builder/templates/ts-scaffold.tmplother556 B
references/mcp-pipeline-builder/templates/tsconfig.json.tmplother408 B
references/ol-SPEC.mdmarkdown2.4 KB
references/ol-state-file.mdmarkdown2.9 KB
references/pipeline-index.jsonconfig23.9 KB
references/pipeline-orchestrator.mdmarkdown15.3 KB
references/pipeline-orchestrator/orchestration-patterns.mdmarkdown8.1 KB
references/pipeline-orchestrator/preferred-patterns.mdmarkdown4.6 KB
references/pipeline-retro.mdmarkdown19.0 KB
references/pipeline-scaffolder.mdmarkdown22.4 KB
references/pipeline-scaffolder/references/architecture-rules.mdmarkdown18.9 KB
references/pipeline-scaffolder/references/generated-skill-template.mdmarkdown1.9 KB
references/pipeline-scaffolder/references/pipeline-spec-format.mdmarkdown36.8 KB
references/pipeline-scaffolder/references/step-menu.mdmarkdown21.5 KB
references/pipeline-scaffolder/scripts/assemble-skill.pyscript6.3 KB
references/pipeline-scaffolder/templates/phases/decision-planning.md.tmplother1.2 KB
references/pipeline-scaffolder/templates/phases/domain-extension.md.tmplother1.5 KB
references/pipeline-scaffolder/templates/phases/generation.md.tmplother427 B
references/pipeline-scaffolder/templates/phases/git-release.md.tmplother1.1 KB
references/pipeline-scaffolder/templates/phases/interaction.md.tmplother965 B
references/pipeline-scaffolder/templates/phases/learning-retro.md.tmplother1.5 KB
references/pipeline-scaffolder/templates/phases/observation.md.tmplother1.3 KB
references/pipeline-scaffolder/templates/phases/research-gathering.md.tmplother1.2 KB
references/pipeline-scaffolder/templates/phases/review.md.tmplother930 B
references/pipeline-scaffolder/templates/phases/safety-guarding.md.tmplother1.7 KB
references/pipeline-scaffolder/templates/phases/structuring.md.tmplother361 B
references/pipeline-scaffolder/templates/phases/synthesis-reporting.md.tmplother1.9 KB
references/pipeline-scaffolder/templates/phases/validation.md.tmplother1.1 KB
references/pipeline-scaffolder/templates/skill-template.md.tmplother12.0 KB
references/pipeline-test-runner.mdmarkdown16.7 KB
references/pl-ambiguity-triage.mdmarkdown2.7 KB
references/pl-check-dimensions.mdmarkdown7.4 KB
references/pl-check-errors.mdmarkdown824 B
references/pl-check-verdict-format.mdmarkdown3.2 KB
references/pl-check.mdmarkdown6.5 KB
references/pl-context-boundary.mdmarkdown1.6 KB
references/pl-depth-first-interview.mdmarkdown11.6 KB
references/pl-empirical-prototype.mdmarkdown825 B
references/pl-executor-ready-plan-template.mdmarkdown7.7 KB
references/pl-human-source-elicitation.mdmarkdown1.5 KB
references/pl-manage.mdmarkdown5.1 KB
references/pl-pause-confirm-and-errors.mdmarkdown2.1 KB
references/pl-pause-extract-decisions.mdmarkdown3.0 KB
references/pl-pause-gather-steps.mdmarkdown2.3 KB
references/pl-pause-synthesize-fields.mdmarkdown2.3 KB
references/pl-pause-write-templates.mdmarkdown5.3 KB
references/pl-pause.mdmarkdown6.5 KB
references/pl-plan-files.mdmarkdown8.4 KB
references/pl-pre-plan.mdmarkdown11.6 KB
references/pl-resume.mdmarkdown12.3 KB
references/pl-spec.mdmarkdown5.2 KB
references/pr-fix-loop.mdmarkdown10.3 KB
references/pr-fix-loop/references/message-formats.mdmarkdown1.6 KB
references/pr-fix-loop/references/publish.mdmarkdown5.4 KB
references/pr-fix-loop/references/review-checklist.mdmarkdown3.4 KB
references/pr-pipeline/references/pr-templates.mdmarkdown5.4 KB
references/pr-pipeline/references/preflight-checklist.mdmarkdown2.8 KB
references/pr-pipeline/references/retro-adr-phases.mdmarkdown2.7 KB
references/pr-pipeline/references/review-fix-loop.mdmarkdown2.0 KB
references/project-coordinator.mdmarkdown6.5 KB
references/project-coordinator/agent-capability-map.mdmarkdown5.4 KB
references/project-coordinator/communication-protocols.mdmarkdown4.5 KB
references/project-coordinator/coordination-playbook.mdmarkdown3.7 KB
references/project-coordinator/death-loop-prevention.mdmarkdown3.6 KB
references/project-coordinator/error-catalog.mdmarkdown2.7 KB
references/project-coordinator/parallel-execution-patterns.mdmarkdown2.8 KB
references/project-coordinator/preferred-patterns.mdmarkdown5.9 KB
references/project-coordinator/todowrite-integration.mdmarkdown5.6 KB
references/research-pipeline.jsscript15.2 KB
references/skill-creation-pipeline.mdmarkdown17.1 KB
references/system-upgrade.mdmarkdown12.8 KB
references/systematic-debugging.mdmarkdown11.0 KB
references/systematic-refactoring.mdmarkdown11.4 KB
references/toolkit-improvement.jsscript39.0 KB
references/toolkit-improvement.mdmarkdown20.5 KB
references/toolkit-improvement/references/adr-template.mdmarkdown10.5 KB
references/toolkit-improvement/references/agent-roster.mdmarkdown15.8 KB
references/workflow-helpers.jsscript12.1 KB
references/workflow-orchestrator.mdmarkdown20.8 KB
references/workflow-orchestrator/references/plan-template.mdmarkdown1.3 KB
references/workflow-orchestrator/references/task-patterns.mdmarkdown23.3 KB
references/workflow-orchestrator/scripts/assemble-plan.pyscript6.9 KB
references/workflow-orchestrator/scripts/validate.pyscript14.4 KB
references/workflow-orchestrator/templates/plan-template.json.tmplother904 B

references/dag-orchestration-examples.md

View on GitHub
# Skill Composition Examples

Real-world examples of skill compositions with complete execution flows.

> **Note**: Scripts referenced below (`discover_skills.py`, `build_dag.py`, `validate.py`) are not yet implemented. These examples illustrate the intended workflow and expected output format.

For error-recovery patterns, adaptive/nested compositions, and aggregate performance metrics, see [dag-orchestration-advanced.md](dag-orchestration-advanced.md).

## Example 1: Feature Development with Tests

### User Request
"Add rate limiting middleware to the API server with comprehensive tests"

### Skill Discovery Output
```bash
$ python3 ~/.claude/skills/workflow/references/discover_skills.py \
    --skills-dir ./skills \
    --output /tmp/skill-index.json
```

```
Discovering skills in ./skills...
Found 18 potential skills
  ✓ workflow-orchestrator
  ✓ test-driven-development
  ✓ verification-before-completion
  ✓ comment-quality
  ✓ code-linting
  ... (13 more skills)

Building skill index...
Index written to: /tmp/skill-index.json

============================================================
SKILL INDEX SUMMARY
============================================================
Total skills: 18

Categories:
  workflow: 2
  testing: 2
  quality: 5
  documentation: 2
  code-analysis: 3
  debugging: 2
  other: 2

Skills with dependencies: 4
============================================================
```

### DAG Building Output
```bash
$ python3 ~/.claude/skills/workflow/references/build_dag.py \
    --task "Add rate limiting middleware with comprehensive tests" \
    --skill-index /tmp/skill-index.json \
    --output /tmp/execution-dag.json
```

```
Analyzing task: Add rate limiting middleware with comprehensive tests

DAG written to: /tmp/execution-dag.json

============================================================
EXECUTION DAG
============================================================

Task: Add rate limiting middleware with comprehensive tests

Task Analysis:
  Primary goals: implementation
  Quality requirements: testing

Selected Skills (3): workflow-orchestrator, test-driven-development, verification-before-completion

Execution Plan:

Phase 1:
  → workflow-orchestrator

Phase 2:
  → test-driven-development

Phase 3:
  → verification-before-completion

Summary:
  Total phases: 3
  Parallel phases: 0
  Skills: 3
============================================================
```

### Validation Output
```bash
$ python3 ~/.claude/skills/toolkit/scripts/skill-composer/validate.py \
    --dag /tmp/execution-dag.json \
    --skill-index /tmp/skill-index.json
```

```
============================================================
SKILL COMPOSITION VALIDATION
============================================================

DAG Structure:
------------------------------------------------------------
  ✓ PASS - DAG has required field: task
  ✓ PASS - DAG has required field: phases
  ✓ PASS - DAG has required field: dependencies
  ✓ PASS - DAG has required field: execution_order
  ✓ PASS - Phases is a list
  ✓ PASS - Phase 1 numbered correctly
  ✓ PASS - Phase 2 numbered correctly
  ✓ PASS - Phase 3 numbered correctly

Acyclic Check:
------------------------------------------------------------
  ✓ PASS - DAG is acyclic (no circular dependencies)

Skill Existence:
------------------------------------------------------------
  ✓ PASS - Skill exists: workflow-orchestrator
  ✓ PASS - Skill exists: test-driven-development
  ✓ PASS - Skill exists: verification-before-completion

I/O Compatibility:
------------------------------------------------------------
  ✓ PASS - Compatibility: workflow-orchestrator → test-driven-development
  ✓ PASS - Compatibility: test-driven-development → verification-before-completion

Topological Ordering:
------------------------------------------------------------
  ✓ PASS - Dependency ordering: workflow-orchestrator → test-driven-development
  ✓ PASS - Dependency ordering: test-driven-development → verification-before-completion
  ✓ PASS - Topological ordering valid

============================================================
SUMMARY: 17/17 checks passed
         Composition valid - ready for execution
============================================================
```

### Execution Result
**Phase 1**: workflow-orchestrator created 4 subtasks:
1. Create rate limiter interface in `middleware/ratelimit.go`
2. Implement token bucket algorithm in `middleware/tokenbucket.go`
3. Add middleware registration in `server/server.go`
4. Add configuration in `config/config.go`

**Phase 2**: test-driven-development implemented each subtask:
- RED: Wrote failing tests for each subtask
- GREEN: Implemented minimum code to pass
- REFACTOR: Improved code quality

**Phase 3**: verification-before-completion validated:
- All tests pass (24/24)
- Code coverage: 94%
- Linting: 0 violations

**Total Duration**: 32 minutes

---

## Example 2: Debug with Documentation

### User Request
"Fix the authentication timeout issue and properly document the root cause"

### DAG Building Output
```
Task: Fix the authentication timeout issue and properly document the root cause

Task Analysis:
  Primary goals: debugging, documentation
  Quality requirements:

Selected Skills (2): systematic-debugging, comment-quality

Execution Plan:

Phase 1:
  → systematic-debugging

Phase 2:
  → comment-quality

Summary:
  Total phases: 2
  Parallel phases: 0
  Skills: 2
```

### Execution Result
**Phase 1**: systematic-debugging:
1. **Reproduce**: Created minimal test case triggering timeout
2. **Isolate**: Identified token validation as bottleneck
3. **Identify**: Found blocking HTTP call in hot path
4. **Verify**: Confirmed fix resolves timeout

**Phase 2**: comment-quality reviewed fix comments:
- Removed: "Fixed timeout bug on 2025-11-30"
- Replaced with: "Token validation uses async HTTP call to prevent blocking"
- Validated: Comments explain WHAT/WHY, not WHEN

**Total Duration**: 18 minutes

---

## Example 3: Parallel Quality Checks

### User Request
"Check code quality and documentation before creating PR"

### DAG Building Output
```
Task: Check code quality and documentation before creating PR

Task Analysis:
  Primary goals:
  Quality requirements: quality_checks

Selected Skills (3): code-linting, comment-quality, verification-before-completion

Execution Plan:

Phase 1 (PARALLEL):
  → code-linting
  → comment-quality

Phase 2:
  → verification-before-completion

Summary:
  Total phases: 2
  Parallel phases: 1
  Skills: 3
```

### Execution Result
**Phase 1 (Parallel)**:
- `code-linting` (6 seconds): Found 3 violations, auto-fixed 2, manual fix needed for 1
- `comment-quality` (4 seconds): Found 2 temporal references ("TODO: fix later", "Bug fixed yesterday")

**Phase 2**:
- `verification-before-completion`: All checks pass after manual fixes

**Total Duration**: 8 minutes (vs 12 minutes sequential = 33% time savings)

---

## Example 4: Research-Driven Implementation

### User Request
"Implement pagination following existing patterns in the codebase"

### DAG Building Output
```
Task: Implement pagination following existing patterns in the codebase

Task Analysis:
  Primary goals: implementation, analysis
  Quality requirements:

Selected Skills (4): pr-workflow (miner), codebase-analyzer, workflow-orchestrator, test-driven-development

Execution Plan:

Phase 1 (PARALLEL):
  → pr-workflow (miner)
  → codebase-analyzer

Phase 2:
  → workflow-orchestrator

Phase 3:
  → test-driven-development

Summary:
  Total phases: 3
  Parallel phases: 1
  Skills: 4
```

### Execution Result
**Phase 1 (Parallel)**:
- `pr-workflow (miner)` (15 seconds): Found 12 PR comments about pagination patterns
  - Tribal knowledge: "Always use cursor-based for large datasets"
  - Standard: "Limit parameter max value: 100"
- `codebase-analyzer` (12 seconds): Extracted pagination patterns from 3 existing implementations
  - Pattern: `page`, `limit`, `cursor` query parameters
  - Helper function: `pkg/pagination/cursor.go`

**Phase 2**:
- `workflow-orchestrator` created subtasks based on learned patterns:
  1. Add cursor-based pagination to handler
  2. Reuse `pkg/pagination/cursor.go` helper
  3. Enforce `limit <= 100` constraint
  4. Add integration tests

**Phase 3**:
- `test-driven-development` implemented following discovered patterns

**Total Duration**: 42 minutes
**Pattern Compliance**: 100% (followed all discovered conventions)

---

## Example 5: Language-Specific Quality Gate

### User Request
"Implement user preferences feature with appropriate quality checks"

### DAG Building (Go Project)
```
Task: Implement user preferences feature with appropriate quality checks

Task Analysis:
  Primary goals: implementation
  Quality requirements: quality_checks
  Domain hints: golang

Selected Skills (3): test-driven-development, go-patterns, verification-before-completion

Execution Plan:

Phase 1:
  → test-driven-development

Phase 2:
  → go-patterns

Phase 3:
  → verification-before-completion
```

### Execution Result
**Phase 1**: test-driven-development
- Implemented feature with tests
- All tests pass (RED → GREEN → REFACTOR)

**Phase 2**: go-patterns (Go-specific)
- golangci-lint: 0 violations
- go test -race: No race conditions
- go build: Successful
- Coverage: 89%

**Phase 3**: verification-before-completion
- All quality gates pass

**Total Duration**: 28 minutes

---

### Alternative: Python Project

**DAG Building (Python Project)**:
```
Selected Skills (3): test-driven-development, python-quality-gate, verification-before-completion
```

**Execution Result (Python)**:
**Phase 2**: python-quality-gate (Python-specific)
- ruff: 0 violations
- pytest: 15/15 tests passed, 92% coverage
- mypy: Type checking passed
- bandit: No security issues

**Total Duration**: 26 minutes

---

### Alternative: Multi-Language Project

**DAG Building (Multi-Language)**:
```
Selected Skills (3): test-driven-development, universal-quality-gate, verification-before-completion
```

**Execution Result (Multi-Language)**:
**Phase 2**: universal-quality-gate (Auto-detected)
- Detected languages: Go, JavaScript
- Go checks: golangci-lint passed, tests passed
- JavaScript checks: Biome passed, jest tests passed

**Total Duration**: 35 minutes

---

## Example 6: Documentation Audit

### User Request
"Audit and improve documentation quality across the codebase"

### DAG Building Output
```
Task: Audit and improve documentation quality across the codebase

Task Analysis:
  Primary goals: documentation, analysis
  Quality requirements:

Selected Skills (2): codebase-analyzer, comment-quality

Execution Plan:

Phase 1:
  → codebase-analyzer

Phase 2:
  → comment-quality

Summary:
  Total phases: 2
  Parallel phases: 0
  Skills: 2
```

### Execution Result
**Phase 1**: codebase-analyzer
- Analyzed 156 files
- Found 42 functions without documentation
- Identified 18 complex functions needing better docs

**Phase 2**: comment-quality
- Reviewed all comments
- Found 23 temporal references
- Suggested improvements for 31 comments

**Generated Report**:
```markdown
# Documentation Audit Report

## Statistics
- Total files: 156
- Undocumented functions: 42 (27%)
- Temporal references: 23
- Poor quality comments: 31

## High Priority Issues
1. `auth/token.go`: No package documentation
2. `server/handler.go`: 8 temporal references
3. `db/query.go`: Complex logic without explanation

## Recommendations
- Add package-level documentation
- Replace temporal references with explanations
- Document complex algorithms
```

**Total Duration**: 35 minutes
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall