Skip to content
futureteaPublic

About

Lightweight, low-token-tax production workflow plugin for Claude Code, Codex, Antigravity, Cursor, and Kimi Code.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

tea-stack

English | 简体中文

A lightweight, low-token-tax workflow plugin for Claude Code, Codex, Antigravity (agy), Cursor, and Kimi Code.

If heavyweight agent frameworks feel too rigid or burn too many tokens on routine work, tea-stack gives you the minimal production guardrails that actually prevent costly mistakes: ~4 KB of baseline rules, 5 focused skills, and a read-only independent code reviewer.

Why tea-stack?

  • Low ceremony, proportional to risk: Move straight to edits on clear small fixes; invoke structured planning and independent review only when changes cross modules or touch contracts.
  • Low token tax, no silent truncation: Compact rules (~4 KB) and small on-demand skills (~1.5–3 KB each) stay well below host context limits.
  • Real independence on reviews: Ships a dedicated read-only code-reviewer sub-agent so critical diffs are audited outside the authoring context.
  • Native multi-tool packaging: One clean repository supporting Claude Code, Codex, Antigravity, Cursor, and Kimi Code out of the box—plus a zero-magic fallback installer.

Install (10 Seconds)

Claude Code

/plugin marketplace add futuretea/tea-stack
/plugin install tea-stack@tea-stack

Antigravity (agy)

agy plugin install https://github.com/futuretea/tea-stack

Codex

codex plugin marketplace add https://github.com/futuretea/tea-stack.git
codex plugin add tea-stack@tea-stack

(Or symlink skills directly via ./install.sh --target codex)

Cursor

/add-plugin https://github.com/futuretea/tea-stack

(Or symlink skills via ./install.sh --target cursor)

Kimi Code

  • TUI Plugin Manager: run /plugins inside Kimi Code and install from https://github.com/futuretea/tea-stack.git (powered by kimi.plugin.json).
  • CLI Skills Directory: pass --skills-dir /path/to/tea-stack/skills, or symlink once via ./install.sh --target kimi.

Symlink Fallback (macOS / Linux — Any Agent)

# Preview symlinks without modifying anything
./install.sh --target all --dry-run

# Supported targets: claude | codex | cursor | kimi | all
./install.sh --target kimi

# Or install into any custom skills directory
./install.sh --skills-dir ~/.config/agents/skills

install.sh only symlinks skills/* and skips existing files/symlinks. It never overwrites your existing global AGENTS.md / CLAUDE.md.

Core Workflow

Task / Requirement
  │
  ├─ Multi-file / Contract / Risky ──▶ write-plan (align scope & verification first)
  │                                        │
  └─ Small & Well-scoped ──────────────────┴──▶ Implement + Run Tests
                                                   │
                          Unexpected failure ◀─────┤
                                 │                 │
                               debug               ▼
                                             review-code (fresh session / code-reviewer)
                                                   │
                                                   ▼
                                             feature-ready (gates + PR summary)

What's Inside

Path Purpose
skills/using-tea-stack/SKILL.md Lightweight workflow router & 5 non-negotiable guardrails
skills/write-plan/SKILL.md One-page implementation plan before editing across modules or changing contracts
skills/debug/SKILL.md Scientific debugging loop: reproduce -> hypothesize -> isolate -> minimal root-cause fix
skills/review-code/SKILL.md Evidence-based P0/P1/P2 code review designed for independent review
skills/feature-ready/SKILL.md Pre-PR readiness check (diff hygiene, deterministic gates, risk review, PR summary draft)
agents/code-reviewer.md Read-only independent reviewer sub-agent definition
rules/AGENTS.md Compact global rule baseline (~4 KB; auto-loaded by Antigravity plugin or merged manually)
templates/PROJECT-AGENTS.md Fill-in-the-blank <150-line repo AGENTS.md / CLAUDE.md template
examples/ Filled-in repo AGENTS.md example + concrete review-code output example
docs/TEAM-PLAYBOOK.md Team rollout guide, anti-patterns, and 2-week pilot plan (中文版)

Plugin Manifests Included

Adopting in a Repository

  1. Install the plugin in your preferred coding agent above.
  2. Copy templates/PROJECT-AGENTS.md to your repo root as AGENTS.md (or CLAUDE.md) and fill in your build/test/lint commands (see examples/project-agents-example.md).
  3. Optionally merge clauses you like from rules/AGENTS.md into your global instructions.

License

MIT

About

Lightweight, low-token-tax production workflow plugin for Claude Code, Codex, Antigravity, Cursor, and Kimi Code.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages