---
name: gstack-document-generate
description: GStack document generation method for turning implementation, product, or operational work into durable docs with clear audience and ownership.
---

# GStack Document Generate Adapter

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

## When To Use

Use this when:

- work should become durable docs;
- architecture wants docs as acceptance;
- a release or feature lacks user/internal documentation;
- the user explicitly invokes `$gstack-document-generate`.

## 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 `Documentation And Learning Methods`.
4. Produce: target docs, audience, outline, content changes, and validation notes.
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`.