# Gstack Health

> GStack health-check method for broad project or repository health review across tests, docs, DX, release readiness, and maintainability.

- Skill: `dirtytrii/gstack-health` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add dirtytrii/gstack-health`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dirtytrii/gstack-health/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Dirtytrii (https://skillmd.com/u/dirtytrii)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/dirtytrii/gstack-health

---


# GStack Health Adapter

This is a Codex role-system adapter for Garry Tan's gstack `gstack-health` method.

## When To Use

Use this when:

- the user asks for project health;
- architecture wants a broad current-state scan;
- QA needs a lightweight readiness map;
- the user explicitly invokes `$gstack-health`.

## Workflow

1. Keep the active role boundary. Do not expand scope just because this gstack method is useful.
2. Read the relevant repo/docs/evidence first when the task depends on current state.
3. Read `../gstack/references/methodology.md` if you need the shared method map, then use the section named `Engineering Execution Methods`.
4. Produce: health summary, top risks, prioritized improvements, and recommended next role prompts.
5. Return the result in the active role's normal format, including boundaries, validation, and unresolved decisions when applicable.

## Boundaries

- Treat upstream gstack as external methodology, not local-owned project state.
- Do not run upstream gstack runtime, telemetry, browser-cookie import, upgrade checks, or host routing injection automatically.
- Do not create or edit `CLAUDE.md`, `.claude/`, `.agents/`, or upstream routing files unless the user explicitly asks for upstream gstack installation work.
- Do not write files, commit, push, deploy, restart, migrate, clean, delete, or change production unless the active role prompt explicitly allows it.
- Preserve this repository's `QA` versus `测试` split: formal test cases/reports belong to `测试` and `$test-case-report-builder`.

