{"id":44004049,"url":"https://github.com/andreaserradev-gbj/dev-workflow","last_synced_at":"2026-04-11T10:15:01.310Z","repository":{"id":335129446,"uuid":"1144377454","full_name":"andreaserradev-gbj/dev-workflow","owner":"andreaserradev-gbj","description":"Claude Code plugin for multi-session development: plan features with structured PRDs, checkpoint progress, and resume across sessions","archived":false,"fork":false,"pushed_at":"2026-02-28T09:34:01.000Z","size":143,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-28T14:12:32.345Z","etag":null,"topics":["claude-code","codex","context-engineering","gemini-cli","spec-driven-development"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andreaserradev-gbj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-28T16:20:38.000Z","updated_at":"2026-02-28T09:27:25.000Z","dependencies_parsed_at":"2026-02-12T11:01:06.303Z","dependency_job_id":null,"html_url":"https://github.com/andreaserradev-gbj/dev-workflow","commit_stats":null,"previous_names":["andreaserradev-gbj/dev-workflow"],"tags_count":23,"template":false,"template_full_name":null,"purl":"pkg:github/andreaserradev-gbj/dev-workflow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andreaserradev-gbj%2Fdev-workflow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andreaserradev-gbj%2Fdev-workflow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andreaserradev-gbj%2Fdev-workflow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andreaserradev-gbj%2Fdev-workflow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andreaserradev-gbj","download_url":"https://codeload.github.com/andreaserradev-gbj/dev-workflow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andreaserradev-gbj%2Fdev-workflow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30460818,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-13T06:34:02.089Z","status":"ssl_error","status_checked_at":"2026-03-13T06:33:49.182Z","response_time":60,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","codex","context-engineering","gemini-cli","spec-driven-development"],"created_at":"2026-02-07T13:07:40.886Z","updated_at":"2026-04-02T13:07:06.042Z","avatar_url":"https://github.com/andreaserradev-gbj.png","language":"Shell","readme":"\u003cdiv align=\"center\"\u003e\n\n# dev-workflow\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Version](https://img.shields.io/badge/version-1.26.2-green.svg)](.claude-plugin/marketplace.json)\n[![AgentSkills.io](https://img.shields.io/badge/standard-AgentSkills.io-purple.svg)](https://agentskills.io)\n\n**AI coding agents forget everything between sessions. This fixes that.**\n\nContext fills up. You restart. Twenty minutes re-explaining what you were building, what you decided, where you left off. Or:\n\n`/dev-resume`\n\n\u003cimg src=\"docs/demo-resume.svg\" alt=\"dev-resume reconstructs full context from a 2KB checkpoint\" width=\"520\"/\u003e\n\n\u003c/div\u003e\n\n---\n\n**Three commands. That's it.** `/dev-plan` once to create a plan. `/dev-checkpoint` when you stop. `/dev-resume` when you come back. Everything comes back — decisions, progress, blockers, the exact next step. Try it once.\n\n---\n\n## The Problem\n\nLLM performance degrades as context fills up. This isn't a theoretical concern — after ~200K tokens of accumulated conversation, tool outputs, and debugging tangents, responses get slower, details get missed, and earlier decisions get contradicted. Even with 1M context windows, **more context means worse output**.\n\nEvery developer using AI coding agents hits the same wall:\n\n- **Session 1:** Great output. Claude is sharp, follows the plan, remembers everything.\n- **Session 1 (continued):** Context filling up. Responses slower. Starts forgetting things you discussed 30 minutes ago.\n- **Session 2:** Fresh start. But now you're the one who has to remember everything and re-explain it. Poorly.\n\nThe common workaround? Manually copy plans into files, paste fragments back into new sessions, hope you didn't forget anything important. It works. It's also tedious, error-prone, and doesn't scale past one feature.\n\n**dev-workflow automates this.** It saves structured progress to disk — not conversation dumps, but the specific state needed to resume: what's done, what's next, what was decided, and what to watch out for. Each new session starts clean with minimal context and full continuity.\n\n---\n\n## How It Works\n\n```\n  Plan          Build         Checkpoint      New Session     Resume\n  ─────         ─────         ──────────      ───────────     ──────\n  /dev-plan  →  implement  →  /dev-checkpoint  →  restart  →  /dev-resume\n                                                                  │\n                                                                  ▼\n                                                            build again...\n```\n\n| Step              | What you do             | What happens                                                         |\n| ----------------- | ----------------------- | -------------------------------------------------------------------- |\n| **1. Plan**       | `/dev-plan`             | Generates a structured PRD in `.dev/` with phases and gates          |\n| **2. Build**      | Implement               | Work until context gets heavy                                        |\n| **3. Checkpoint** | `/dev-checkpoint`       | Saves progress, git state, decisions, next steps                     |\n| **4. Restart**    | Close and reopen Claude | Fresh context window, clean slate                                    |\n| **5. Resume**     | `/dev-resume`           | Loads ~2KB checkpoint, rebuilds context, picks up where you left off |\n\n**Repeat steps 2–5** until the feature is complete. Each session starts fresh with high-quality context.\n\n---\n\n## Installation\n\n### Claude Code (Plugin)\n\n```\n/plugin marketplace add andreaserradev-gbj/dev-workflow\n/plugin install dev-workflow\n```\n\n\u003cdetails\u003e\n\u003csummary\u003eUpdating \u0026 Troubleshooting\u003c/summary\u003e\n\n```\n/plugin marketplace update dev-workflow\n```\n\nIf the plugin doesn't load after updating, clear the cache and reinstall:\n\n```bash\nrm -rf ~/.claude/plugins/cache/dev-workflow\nrm -rf ~/.claude/plugins/marketplaces/dev-workflow\n```\n\nThen re-run the install commands above.\n\n\u003c/details\u003e\n\n### Codex\n\nTell Codex:\n\n\u003e Clone `https://github.com/andreaserradev-gbj/dev-workflow.git` and follow `.codex/INSTALL.md` from the local checkout.\n\nOr see [docs/README.codex.md](docs/README.codex.md) for manual setup.\n\n### Gemini CLI\n\n```bash\ngemini skills install https://github.com/andreaserradev-gbj/dev-workflow.git --path plugins/dev-workflow/skills\n```\n\nOr see [docs/README.gemini.md](docs/README.gemini.md) for alternatives.\n\n---\n\n## Skills\n\n### `/dev-plan` — Plan a feature\n\nCreates a structured PRD with phases, status markers, and gates. Three phases:\n\n1. **Understand** — gather requirements (or infer from inline arguments)\n2. **Research** — explore the codebase using parallel agents\n3. **Write** — produce `.dev/\u003cfeature-name\u003e/00-master-plan.md`\n\n```\n/dev-plan add OAuth login with Google and GitHub providers\n/dev-plan refactor the database layer to use connection pooling\n```\n\n### `/dev-checkpoint` — Save progress\n\n\u003cimg src=\"docs/demo-checkpoint.svg\" alt=\"dev-checkpoint saves progress, decisions, and blockers\" width=\"520\"/\u003e\n\nCaptures everything needed to resume later:\n\n- Updates PRD status markers (`⬜` → `✅`)\n- Captures git state (branch, last commit, uncommitted changes)\n- Records decisions, blockers, and next steps\n- Writes `.dev/\u003cfeature-name\u003e/checkpoint.md`\n\n```\n/dev-checkpoint\n/dev-checkpoint oauth-login\n```\n\n### `/dev-resume` — Pick up where you left off\n\nReconstructs context from a checkpoint:\n\n- Loads the checkpoint and verifies state (branch, staleness, drift)\n- Builds a focused summary with a concrete \"Start with\" action\n- Enforces phase gates — won't skip ahead without your approval\n\n```\n/dev-resume\n/dev-resume oauth-login\n```\n\n### `/dev-wrapup` — Extract session learnings\n\nReviews the conversation for insights worth keeping:\n\n- Scans for corrections, conventions, and project quirks\n- Routes findings to the right place (project docs, scoped rules, user memory)\n- Applies nothing without explicit confirmation\n- Learns your preferences over time via `.dev/wrapup-feedback.json`\n\n```\n/dev-wrapup\n```\n\n### `/dev-dashboard` — Live cross-project view\n\n\u003cimg src=\"docs/dashboard-preview.png\" alt=\"Dev Dashboard showing projects with feature progress, status badges, and phase tracking\" width=\"720\"/\u003e\n\nA local web server that scans `.dev/` folders across all your projects and shows live feature status in the browser. Real-time updates via WebSocket — edit a PRD and the dashboard reflects changes instantly. Works with any AI coding tool (Claude Code, Codex, Gemini CLI, etc.) — it reads `.dev/` PRDs directly, no AI integration needed.\n\n```\n/dev-dashboard\n```\n\nStarts the server (or reuses an existing instance) and displays the URL. No setup required — the server is bundled with the plugin.\nOn first run, `/dev-dashboard` also installs local `dev-dashboard` and `dev-dashboard-stop`\ncommands so future terminal launches reuse the same bundled launcher.\n\n**Dashboard actions:**\n\n| Action               | Where                                   | What it does                                                  |\n| -------------------- | --------------------------------------- | ------------------------------------------------------------- |\n| **Archive**          | Feature row / panel (complete features) | Moves `.dev/\u003cname\u003e` to `.dev-archive/` with confirmation      |\n| **Restore**          | Feature row / panel (archived features) | Moves `.dev-archive/\u003cname\u003e` back to `.dev/` with confirmation |\n| **Copy as Markdown** | Report view                             | Copies activity report as formatted markdown                  |\n\n\u003cdetails\u003e\n\u003csummary\u003eConfiguration\u003c/summary\u003e\n\nConfig lives at `~/.config/dev-dashboard/config.json` (created automatically on first run). Fresh installs start with no scan roots, and the dashboard prompts you to save them explicitly on first launch:\n\n```json\n{\n  \"scanDirs\": [\"~/code\", \"~/work\"],\n  \"port\": 3141,\n  \"notifications\": false,\n  \"scanDirsConfigured\": true\n}\n```\n\n| Field                | Type       | Default | Description                                                          |\n| -------------------- | ---------- | ------- | -------------------------------------------------------------------- |\n| `scanDirs`           | `string[]` | `[]`    | Directories to scan for projects containing `.dev/` folders          |\n| `port`               | `number`   | `3141`  | HTTP server port                                                     |\n| `notifications`      | `boolean`  | `false` | Reserved for future notification support                             |\n| `scanDirsConfigured` | `boolean`  | `false` | Marks whether first-run scan-directory onboarding has been completed |\n\nSee [tools/dev-dashboard/README.md](tools/dev-dashboard/README.md) for CLI flags and more details.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eRunning from the terminal\u003c/summary\u003e\n\nRun `/dev-dashboard` once to install the local commands, then use:\n\n```bash\ndev-dashboard\ndev-dashboard-stop\n```\n\nThe installer writes Unix command shims to `~/.local/bin` by default, or to\n`$DEV_DASHBOARD_BIN_DIR` if you override it. If the install reports that the bin\ndirectory is not on `PATH`, add that directory to your shell config before using\nthe commands directly in a terminal.\n\nThis installer-backed path is the primary terminal UX for this release. Manual\nshell snippets are no longer the recommended default.\n\n\u003c/details\u003e\n\n---\n\n## Design Principles\n\n**Composable, not prescribed.** Each skill is independent. Use `/dev-plan` without `/dev-checkpoint`. Use `/dev-resume` alongside `/code-review`, Jira, Slack, or any other tool. Start a session without any plan at all. The skills work together but never force a sequence.\n\n**Plans are living documents.** PRDs have status markers (`⬜` / `✅` / `⏭️`) and phase gates (`⏸️ GATE`). They're meant to be edited mid-flight — add phases, skip steps, rewrite sections when requirements change. Checkpoints capture the decisions behind those changes.\n\n**Context quality over context quantity.** Checkpoints are structured compression — they preserve what matters (state, decisions, next actions) and deliberately discard what doesn't (debugging tangents, tool output, failed attempts). Each resumed session starts lean.\n\n---\n\n## Git Tracking\n\n`.dev/` and `.dev-archive/` are tracked in git by default — PRDs, checkpoints, and archived features become part of your project history. To exclude them:\n\n```\n# .gitignore\n.dev/\n.dev-archive/\n```\n\n---\n\n## Tips\n\n- **Checkpoint before context fills up** — don't wait until you're forced to restart\n- **Use `/dev-plan` for complex features** — for quick fixes, just work directly\n- For large features, ask Claude to **break the PRD into sub-documents** during `/dev-plan`\n\n## License\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandreaserradev-gbj%2Fdev-workflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandreaserradev-gbj%2Fdev-workflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandreaserradev-gbj%2Fdev-workflow/lists"}