{"id":49809839,"url":"https://github.com/periant-llc/pstack","last_synced_at":"2026-05-16T04:24:11.066Z","repository":{"id":355104443,"uuid":"1226748092","full_name":"periant-llc/pstack","owner":"periant-llc","description":"Power Stack — a Claude Code workflow toolkit for AI-paced development. Composes gstack, Superpowers, and GitNexus into a domain → feature → story workflow.","archived":false,"fork":false,"pushed_at":"2026-05-12T17:01:57.000Z","size":118,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-12T18:33:20.584Z","etag":null,"topics":["ai-development","claude-code","claude-code-skills","developer-tools","workflow-automation"],"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/periant-llc.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-05-01T19:37:54.000Z","updated_at":"2026-05-12T17:14:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/periant-llc/pstack","commit_stats":null,"previous_names":["periant-llc/pstack"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/periant-llc/pstack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/periant-llc%2Fpstack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/periant-llc%2Fpstack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/periant-llc%2Fpstack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/periant-llc%2Fpstack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/periant-llc","download_url":"https://codeload.github.com/periant-llc/pstack/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/periant-llc%2Fpstack/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32961787,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-12T23:30:32.555Z","status":"ssl_error","status_checked_at":"2026-05-12T23:30:18.191Z","response_time":102,"last_error":"SSL_read: 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":["ai-development","claude-code","claude-code-skills","developer-tools","workflow-automation"],"created_at":"2026-05-13T00:03:50.989Z","updated_at":"2026-05-13T00:03:54.154Z","avatar_url":"https://github.com/periant-llc.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pstack\n\n\u003e Power Stack — a Claude Code workflow toolkit for AI-paced development.\n\nA skill bundle that combines the best of gstack (planning, design, QA), Superpowers (TDD, plans, brainstorming), GitHub MCP (Issues/PRs without `gh`), GitNexus (knowledge graph), and team-specific conventions into a coherent workflow for shipping AI-paced code.\n\n## Philosophy\n\n- **Three-layer content model.** Vision (strategic, in a pinned GitHub Issue) → Domain (long-lived, in `docs/domains/`) → Feature/Story (drafty Epic body → frozen `docs/specs/`).\n- **Author/Dev split.** Non-tech authors file Feature Requests via GitHub web UI; technical leads run `/pstack-plan` to promote them to Epics with specs; engineers run `/pstack-execute` to build. Pstack runs in Claude Desktop or Claude Code.\n- **Compose, don't reinvent.** Pstack recipes orchestrate gstack and Superpowers skills rather than reimplementing them.\n- **Drafty in GitHub, stable in git.** Specs iterate in Epic issue bodies (web-UI editable, no PR ceremony) and freeze to `docs/specs/\u003cname\u003e.md` on the first story's PR.\n- **Smaller PRs, faster reviews.** Decomposition is a first-class step.\n\n## Install\n\n### Option A — Claude Code plugin (recommended)\n\nFrom any Claude Code session:\n\n```\n/plugin marketplace add periant-llc/pstack\n/plugin install pstack@pstack\n```\n\nThe `pstack@pstack` form is `\u003cplugin-name\u003e@\u003cmarketplace-name\u003e` — both happen to be `pstack` since this repo is a single-plugin marketplace.\n\nAfter install, pstack's skills are available as `/pstack-*` commands.\n\n**Claude Desktop note:** Claude Desktop's Code-mode plugin browser supports the same marketplace format. Author-side skills use GitHub MCP for GitHub operations, so they work in Desktop without `gh` CLI or a local clone (for `/pstack-plan`, `/pstack-issue`, `/pstack-office-hours`, `/pstack-brief`).\n\n### Option B — Legacy clone + setup (for hacking on pstack itself)\n\n```bash\ngit clone https://github.com/periant-llc/pstack ~/Development/ai/pstack\n~/Development/ai/pstack/scripts/setup.sh\n```\n\nThis symlinks each skill into `~/.claude/skills/` (10 canonical + 10 `ps-*` aliases) and installs a `pstack-init` CLI shim into `~/.local/bin/` for terminal use. Restart Claude Code to pick up the skills. Best for contributors editing pstack itself — for normal use, prefer the plugin path.\n\n## Usage\n\nFrom a Claude Code session inside a project, the workflow commands:\n\n| Skill | Purpose |\n|---|---|\n| `/pstack-init` | scaffold project structure (`docs/`, `CLAUDE.md`, `.pstack-version`) |\n| `/pstack-office-hours` | brainstorm strategic Vision; posts to a pinned GitHub Issue editable by non-tech authors |\n| `/pstack-plan [\u003cissue#\u003e]` | full feature/refactor ceremony; promote a Feature Request to an Epic with sub-stories |\n| `/pstack-prototype` | exploratory build (monorepo: lands in `apps/lab/\u003cname\u003e/`) |\n| `/pstack-research` | spike with research doc as output |\n| `/pstack-issue` | single GitHub issue with shape selector (story/task/bug/feature/epic/docs) |\n| `/pstack-domain` | create or update a domain doc |\n| `/pstack-execute \u003c#\u003e` | pick up an issue, freeze spec on first story, TDD-implement |\n| `/pstack-pr` | enforce conventional commits, run full review gauntlet, open PR |\n| `/pstack-brief \u003cpr\u003e` | reviewer-side AI brief on a PR |\n| `/pstack-anti-pattern` | log a failed approach to `docs/anti-patterns.md` |\n| `/pstack-setup-release-please` | opt-in: scaffold pstack's standardized release-please automation into the project |\n\nAliases: `ps-init`, `ps-plan`, `ps-prototype`, etc. (legacy install only — the plugin uses the canonical `pstack-*` names).\n\nSee [`docs/architecture/commands.md`](docs/architecture/commands.md) for the full locked command set.\n\n## Architecture\n\nFour layers map work from strategic context down to single PRs:\n\n- **Vision** (pinned GitHub Issue, `label:vision`) — strategic context. Web-UI editable by non-tech authors.\n- **Domain** (`docs/domains/\u003cname\u003e.md`) — long-lived product surface. Living doc. `paths:` frontmatter maps code locations; `depends_on:` / `consumers:` document inter-domain interfaces.\n- **Feature** — drafty spec lives in a GitHub Epic body; frozen to `docs/specs/\u003cname\u003e.md` by `/pstack-execute` on the first story.\n- **Story** — GitHub issue. Linked to a spec via `Parent Epic: #N`. Maps to one of: User Story, Task, Bug, Feature, Epic, Docs.\n\n`pstack-plan` orchestrates feature definition: brainstorms with the author, writes the spec into a new Epic body, decomposes into 2–3 stories, and files them all on GitHub. `pstack-execute` then handles implementation, freezing the spec into git as the first commit of the first story's PR.\n\nSee [`docs/architecture/`](docs/architecture/) for full details:\n- [`commands.md`](docs/architecture/commands.md) — the locked command set\n- [`three-layer-model.md`](docs/architecture/three-layer-model.md) — domain/feature/story layers (Vision will be added soon)\n- [`frontmatter.md`](docs/architecture/frontmatter.md) — YAML frontmatter conventions for rendered docs\n\n## Roadmap\n\nActive deferred work — commands and patterns to build when real usage demands them — is tracked in [`IDEAS.md`](IDEAS.md). Includes:\n\n- Domain-aware subagent dispatch (v0.3) — load only relevant domain context per subagent\n- `/pstack-handover` + `/pstack-resume` for cross-session work\n- `/pstack-hotfix` for production-bug-specific ceremony\n- pstack-lite DXT for non-tech authors in Claude Desktop (collapsed into the plugin path above — pstack now works in Desktop directly via GitHub MCP)\n\n## Releases\n\nPstack uses [release-please](https://github.com/googleapis/release-please) for automated, bot-driven releases. On every push to `main`, the workflow reads conventional-commit prefixes since the last tag and opens a \"Release vX.Y.Z\" PR with an auto-generated CHANGELOG. Merging the PR creates the tag + GitHub Release.\n\nThis is the **standardized release tooling for pstack-managed projects**. Apply it to your own project on demand: `/pstack-setup-release-please`.\n\n## Status\n\n**v0.2.0** — Vision layer + drafty-spec-in-Epic-body + MCP-based author-side skills + full review-gauntlet orchestration + Claude Code plugin packaging + release-please automation. 12 skills total. Next: dogfood against a real project, observe gaps, fill in GitNexus query endpoints.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fperiant-llc%2Fpstack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fperiant-llc%2Fpstack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fperiant-llc%2Fpstack/lists"}