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

# 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`.