convez.ai
Skill
misiekhardcore

claude-workflow

misiekhardcore/claude-workflow

Ver no GitHub
InicialPluginScore · de 0 a 100

Workflow skills plugin for Claude Code — discovery, define, implement lifecycle

Instalação

$npx convez-ai misiekhardcore/claude-workflow

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 2 dias
Versão
v2.1.0
Issues abertas
11
Contribuidores
2

README

A tradução para o português deste README ainda está na fila.

claude-workflow

Workflow skills plugin for Claude Code — a standardized lifecycle for feature development.

%%{init: {'theme':'base', 'themeVariables': {'background':'#000','primaryColor':'#ffffff','primaryTextColor':'#000000','primaryBorderColor':'#000000','lineColor':'#000000','textColor':'#000000','titleColor':'#000000','clusterBkg':'#f3f4f6','clusterBorder':'#000000','edgeLabelBackground':'#ffffff'}}}%%
flowchart TB
    subgraph Canvas["Skills flowchart"]
        direction TB
        Start([feature request]) --> Discovery

        subgraph Discovery["/discovery — explore & scope"]
            direction LR
            D_Describe["/describe — problem space"]
            D_Specify["/specify — acceptance criteria"]
            D_Scout["Prior-Art Scout"]
            D_Scout -.seed brief.-> D_Describe
        end

        subgraph Define["/define — solution architecture"]
            direction LR
            Df_Arch["/architecture — tech decisions"]
            Df_Design["/design — UX/UI"]
        end

        subgraph Implement["/implement — build loop"]
            direction LR
            I_Build["/build — TDD"]
            I_Review["/review — correctness + standards"]
            I_Verify["/verify — AC QA"]
            I_Build --> I_Review --> I_Verify
            I_Verify -.fix brief.-> I_Build
            I_Review -.fix brief.-> I_Build
        end

        Discovery -->|create issue body| Define
        Define -->|issue body| Implement
        Implement --> PR([draft PR])
        PR --> Compound["/compound — capture learnings"]
        PR --> ResolvePR["/resolve-pr-feedback — batch review responses"]
        PR --> WrapUp["/wrap-up — remove worktree + branch"]

        subgraph Meta["Other tools"]
            direction LR
            EpicAutopilot["/epic-autopilot — autonomous epic→PR"]
            IssueAutopilot["/issue-autopilot — single-issue end-to-end"]
            NewSkill["/new-skill"]
            FindSkills["/find-skills"]
            Prune["/prune — audit memory"]
            AuditIssues["/audit-issues — drift-check open issues"]
            GrillMe["/grill-me"]
        end

        GrillMe -.-> D_Describe
        GrillMe -.-> D_Specify
        GrillMe -.-> Df_Arch
        GrillMe -.-> Df_Design
        GrillMe -.-> NewSkill

        subgraph Obsidian["claude-obsidian (optional)"]
            direction LR
            Save["/save"]
            WikiQuery["wiki-query"]
            WikiLint["wiki-lint"]
        end
        Compound -. filing .-> Save
        Df_Arch -. prior patterns .-> WikiQuery
        Define -. prior decisions .-> WikiQuery
        Prune -. vault audit .-> WikiLint
    end

    classDef canvas fill:#ffffff,stroke:#ffffff,color:#000000
    classDef orch fill:#dddddd,stroke:#000000,stroke-width:2px,color:#000000
    classDef spec fill:#eeeeee,stroke:#000000,stroke-width:2px,color:#000000
    classDef prim fill:#a5b4fc,stroke:#000000,stroke-width:2px,color:#000000
    classDef meta fill:#d1d5db,stroke:#000000,stroke-width:2px,color:#000000
    classDef ext  fill:#f9a8d4,stroke:#000000,stroke-width:2px,stroke-dasharray:4 2,color:#000000
    class Canvas canvas
    class Discovery,Define,Implement orch
    class D_Describe,D_Specify,D_Scout,Df_Arch,Df_Design,I_Build,I_Review,I_Verify spec
    class GrillMe,NewSkill,FindSkills,Prune,AuditIssues,WrapUp,Compound,ResolvePR,EpicAutopilot,IssueAutopilot,Save,WikiQuery,WikiLint meta
    class Obsidian ext

Legend: phase orchestrators (gray subgraphs) spawn specialists (light nodes) that do the bounded work. Plugin-level tools run outside the phase lifecycle. The claude-obsidian subgraph shows integrations that activate only when installed.

Install

claude plugin marketplace add misiekhardcore/claude-workflow
claude plugin install claude-workflow@claude-workflow

Then enable it in your project or globally in Claude Code settings.

Skills

SkillDescription
/discoveryExplore a problem and produce a GitHub issue with acceptance criteria
/definePlan architecture and design; produces the implementation handoff
/implementFull build→review→verify cycle, ends with a draft PR
/epic-autopilotAutonomous epic→PR pipeline; chains /discovery → /define → /implement per sub-issue
/issue-autopilotSingle-issue end-to-end pipeline: /define → /implement → /resolve-pr-feedback → /compound → /wrap-up
/buildCode against an issue's acceptance criteria using TDD
/reviewReview an implementation or external PR; correctness, standards, and conditional specialists
/verifyQA verification of every acceptance criterion
/describeExplore and understand a problem space interactively
/specifyTurn a problem statement into testable acceptance criteria
/architectureDecide on technical architecture — components, data flow, trade-offs
/designVisual and UX design decisions — layouts, interaction flows
/grill-meRelentless interviewing to stress-test a plan or design
/compoundCapture learnings as structured wiki notes
/wrap-upPost-PR cleanup: remove feature worktree, delete branch, clear NOTES.md
/pruneAudit CLAUDE.md, SKILL.md, and memory for staleness
/audit-issuesDrift-check open GitHub issues against the current repo state
/find-skillsDiscover and install skills from the ecosystem
/resolve-pr-feedbackProcess PR review feedback in bulk
/new-skillScaffold a new skill conforming to this authoring standard

Optional: claude-obsidian integration

When installed and bootstrapped, several skills light up vault-aware paths:

  • /compound files captures via /save instead of reporting inline.
  • /prune delegates vault audit to wiki-lint.
  • /architecture and /define query the vault for prior patterns/decisions.

Without claude-obsidian, every skill still runs; vault operations are skipped with a note, and /compound emits a structured Markdown block for manual capture. No hard dependency.

Workflow paths

Task sizePath
Trivial fix/implement directly
Medium feature/discovery → /implement
Large feature / epic/discovery → /define → /implement

Full lifecycle walkthrough: docs/workflow.md

Token budgets and CLAUDE.md placement

Per-artifact and per-phase token budgets, context-rot threshold, CLAUDE.md placement, and @-import syntax: docs/token-budgets.md. Context-hygiene rationale: docs/context-hygiene.md.

Ecosystem

Multi-plugin coordination: MCP scope, inter-plugin dependencies, optional claude-obsidian integration via runtime detection: docs/cross-plugin.md.

Authoring standard

  • Templates: role-specific skeletons in _templates/
  • Convention doc: _templates/AUTHORING.md — skill types, frontmatter, _shared/ references
  • Scaffolder: /new-skill — interactive generator

Shared protocols at _shared/:

FilePurpose
compaction-protocol.mdContext editing → delegation → /compact order
composition.mdMulti-skill composition patterns and contracts
handoff-artifact.mdFive-field GitHub issue handoff protocol; per-skill section headings defined in each producing skill
interviewing-rules.mdOne-question-at-a-time interview protocol
notes-md-protocol.mdIn-phase NOTES.md memory layer
orchestrator-rules.mdShared rules for pipeline orchestrators: CWD verification, delegation, no-autonomous-merge, seed-brief contract
seed-brief.mdSpawn-time context packaging (YAML-in-XML) for orchestrator→specialist handoff; payload types defined in specialist-mode

Releasing

Versions in .claude-plugin/plugin.json and .claude-plugin/marketplace.json (both metadata.version and plugins[0].version) must agree. Trigger the Release workflow via workflow_dispatch to bump all three in lockstep, commit, tag, and publish.

Per-release notes with full diffs: GitHub Releases. In-repo summary: CHANGELOG.md.

License

PolyForm Noncommercial License 1.0.0 — free for personal and open-source use; commercial use requires a separate agreement.

Ver o original no GitHub

Bom para

Relacionados