Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 11 additions & 22 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,36 +49,29 @@ TaskWing helps turn a goal into executed tasks with persistent context across AI
### Supported Models

<!-- TASKWING_PROVIDERS_START -->

[![OpenAI](https://img.shields.io/badge/OpenAI-412991?logo=openai&logoColor=white)](https://platform.openai.com/)
[![Anthropic](https://img.shields.io/badge/Anthropic-191919?logo=anthropic&logoColor=white)](https://www.anthropic.com/)
[![Google Gemini](https://img.shields.io/badge/Google_Gemini-4285F4?logo=google&logoColor=white)](https://ai.google.dev/)
[![AWS Bedrock](https://img.shields.io/badge/AWS_Bedrock-OpenAI--Compatible_Beta-FF9900?logo=amazonaws&logoColor=white)](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-chat-completions.html)
[![Ollama](https://img.shields.io/badge/Ollama-Local-000000?logo=ollama&logoColor=white)](https://ollama.com/)

<!-- TASKWING_PROVIDERS_END -->

### Works With

<!-- TASKWING_TOOLS_START -->

[![Claude Code](https://img.shields.io/badge/Claude_Code-191919?logo=anthropic&logoColor=white)](https://www.anthropic.com/claude-code)
[![OpenAI Codex](https://img.shields.io/badge/OpenAI_Codex-412991?logo=openai&logoColor=white)](https://developers.openai.com/codex)
[![Cursor](https://img.shields.io/badge/Cursor-111111?logo=cursor&logoColor=white)](https://cursor.com/)
[![GitHub Copilot](https://img.shields.io/badge/GitHub_Copilot-181717?logo=githubcopilot&logoColor=white)](https://github.com/features/copilot)
[![Gemini CLI](https://img.shields.io/badge/Gemini_CLI-4285F4?logo=google&logoColor=white)](https://github.com/google-gemini/gemini-cli)
[![OpenCode](https://img.shields.io/badge/OpenCode-000000?logo=opencode&logoColor=white)](https://opencode.ai/)

<!-- TASKWING_TOOLS_END -->

<!-- TASKWING_LEGAL_START -->

Brand names and logos are trademarks of their respective owners; usage here indicates compatibility, not endorsement.

<!-- TASKWING_LEGAL_END -->

### Slash Commands

- /tw-ask - Use when you need to search project knowledge (decisions, patterns, constraints).
- /tw-remember - Use when you want to persist a decision, pattern, or insight to project memory.
- /tw-next - Use when you are ready to start the next approved TaskWing task with full context.
Expand All @@ -92,9 +85,8 @@ Brand names and logos are trademarks of their respective owners; usage here indi
### Core Commands

<!-- TASKWING_COMMANDS_START -->

- taskwing bootstrap
- taskwing goal "<goal>"
- taskwing plan "<description>"
- taskwing ask "<query>"
- taskwing task
- taskwing plan status
Expand All @@ -108,31 +100,28 @@ Brand names and logos are trademarks of their respective owners; usage here indi
### MCP Tools (Canonical Contract)

<!-- TASKWING_MCP_TOOLS_START -->

| Tool | Description |
| -------- | ----------------------------------------------------------------------- |
| ask | Search project knowledge (decisions, patterns, constraints) |
| task | Unified task lifecycle (next, current, start, complete) |
| plan | Plan management (clarify, decompose, expand, generate, finalize, audit) |
| code | Code intelligence (find, search, explain, callers, impact, simplify) |
| debug | Diagnose issues systematically with AI-powered analysis |
| remember | Store knowledge in project memory |

| Tool | Description |
|------|-------------|
| ask | Search project knowledge (decisions, patterns, constraints) |
| task | Unified task lifecycle (next, current, start, complete) |
| plan | Plan management (clarify, decompose, expand, generate, finalize, audit) |
| code | Code intelligence (find, search, explain, callers, impact, simplify) |
| debug | Diagnose issues systematically with AI-powered analysis |
| remember | Store knowledge in project memory |
<!-- TASKWING_MCP_TOOLS_END -->

### Autonomous Task Execution (Hooks)

TaskWing integrates with Claude Code's hook system for autonomous plan execution:

```bash
~~~bash
taskwing hook session-init # Initialize session tracking (SessionStart hook)
taskwing hook continue-check # Check if should continue to next task (Stop hook)
taskwing hook session-end # Cleanup session (SessionEnd hook)
taskwing hook status # View current session state
```
~~~

Circuit breakers prevent runaway execution:

- --max-tasks=5 stops after N tasks for human review.
- --max-minutes=30 stops after N minutes.

Expand Down
46 changes: 22 additions & 24 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,9 +83,9 @@ TaskWing gives AI coding assistants permanent memory. It extracts architectural
cmd/ # Cobra CLI commands
├── root.go # Base command, global flags (--json, --verbose, --preview, --quiet)
├── bootstrap.go # Auto-generate knowledge from repo
├── goal.go # Goal-first flow: clarify -> generate -> activate
├── goal.go # Deprecated: routes to plan command
├── knowledge.go # View stored project knowledge nodes
├── plan.go # Plan lifecycle management
├── plan.go # Plan creation (primary entry), lifecycle management
├── task.go # Task lifecycle management
├── slash.go # Slash command content for assistants
├── mcp_server.go # MCP server for AI tool integration
Expand Down Expand Up @@ -141,7 +141,7 @@ Uses CloudWeGo Eino for multi-provider support:
- Bedrock: Set `BEDROCK_API_KEY`, `TASKWING_LLM_PROVIDER=bedrock`, and `TASKWING_LLM_BEDROCK_REGION=<region>`
- Ollama: Set `TASKWING_LLM_PROVIDER=ollama` and `TASKWING_LLM_MODEL=<model>`

**Bootstrap requires an LLM API key by default** to analyze architecture. Use `--skip-analyze` for CI/testing without LLM (hidden flag, deterministic mode only).
**Bootstrap auto-enables architecture analysis** when an AI CLI is detected on PATH. Use `--no-analyze` to skip.

### MCP Server

Expand Down Expand Up @@ -235,7 +235,7 @@ Increment when:

**NOT MINOR**: Internal refactors, new internal modules, code reorganization

Examples: new `taskwing goal` command, new `--format` flag, adding Gemini provider
Examples: new `taskwing plan` shortcut, new `--format` flag, adding Gemini provider

### MAJOR (X.0.0) - Breaking changes only

Expand Down Expand Up @@ -338,7 +338,6 @@ Brand names and logos are trademarks of their respective owners; usage here indi
<!-- TASKWING_LEGAL_END -->

### Slash Commands

- /tw-ask - Use when you need to search project knowledge (decisions, patterns, constraints).
- /tw-remember - Use when you want to persist a decision, pattern, or insight to project memory.
- /tw-next - Use when you are ready to start the next approved TaskWing task with full context.
Expand All @@ -352,44 +351,43 @@ Brand names and logos are trademarks of their respective owners; usage here indi
### Core Commands

<!-- TASKWING_COMMANDS_START -->
- `taskwing bootstrap`
- `taskwing goal "<goal>"`
- `taskwing ask "<query>"`
- `taskwing task`
- `taskwing plan status`
- `taskwing slash`
- `taskwing mcp`
- `taskwing doctor`
- `taskwing config`
- `taskwing start`
- taskwing bootstrap
- taskwing plan "<description>"
- taskwing ask "<query>"
- taskwing task
- taskwing plan status
- taskwing slash
- taskwing mcp
- taskwing doctor
- taskwing config
- taskwing start
<!-- TASKWING_COMMANDS_END -->

### MCP Tools (Canonical Contract)

<!-- TASKWING_MCP_TOOLS_START -->
| Tool | Description |
|------|-------------|
| `ask` | Search project knowledge (decisions, patterns, constraints) |
| `task` | Unified task lifecycle (`next`, `current`, `start`, `complete`) |
| `plan` | Plan management (`clarify`, `decompose`, `expand`, `generate`, `finalize`, `audit`) |
| `code` | Code intelligence (`find`, `search`, `explain`, `callers`, `impact`, `simplify`) |
| `debug` | Diagnose issues systematically with AI-powered analysis |
| `remember` | Store knowledge in project memory |
| ask | Search project knowledge (decisions, patterns, constraints) |
| task | Unified task lifecycle (next, current, start, complete) |
| plan | Plan management (clarify, decompose, expand, generate, finalize, audit) |
| code | Code intelligence (find, search, explain, callers, impact, simplify) |
| debug | Diagnose issues systematically with AI-powered analysis |
| remember | Store knowledge in project memory |
<!-- TASKWING_MCP_TOOLS_END -->

### Autonomous Task Execution (Hooks)

TaskWing integrates with Claude Code's hook system for autonomous plan execution:

```bash
~~~bash
taskwing hook session-init # Initialize session tracking (SessionStart hook)
taskwing hook continue-check # Check if should continue to next task (Stop hook)
taskwing hook session-end # Cleanup session (SessionEnd hook)
taskwing hook status # View current session state
```
~~~

Circuit breakers prevent runaway execution:

- --max-tasks=5 stops after N tasks for human review.
- --max-minutes=30 stops after N minutes.

Expand Down
41 changes: 19 additions & 22 deletions GEMINI.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,8 +77,7 @@ The system is composed of a CLI tool with an embedded MCP server and a web dashb
| Command | Description |
| :------------------- | :---------------------------------------- |
| `taskwing bootstrap` | Initialize project memory |
| `taskwing goal` | Create and activate a plan |
| `taskwing plan` | Manage development plans |
| `taskwing plan` | Create and manage development plans |
| `taskwing task` | Manage execution tasks |
| `taskwing start` | Start API/watch/dashboard services |
| `taskwing slash` | Output slash command prompts for AI tools |
Expand Down Expand Up @@ -217,7 +216,6 @@ Brand names and logos are trademarks of their respective owners; usage here indi
<!-- TASKWING_LEGAL_END -->

### Slash Commands

- /tw-ask - Use when you need to search project knowledge (decisions, patterns, constraints).
- /tw-remember - Use when you want to persist a decision, pattern, or insight to project memory.
- /tw-next - Use when you are ready to start the next approved TaskWing task with full context.
Expand All @@ -231,44 +229,43 @@ Brand names and logos are trademarks of their respective owners; usage here indi
### Core Commands

<!-- TASKWING_COMMANDS_START -->
- `taskwing bootstrap`
- `taskwing goal "<goal>"`
- `taskwing ask "<query>"`
- `taskwing task`
- `taskwing plan status`
- `taskwing slash`
- `taskwing mcp`
- `taskwing doctor`
- `taskwing config`
- `taskwing start`
- taskwing bootstrap
- taskwing plan "<description>"
- taskwing ask "<query>"
- taskwing task
- taskwing plan status
- taskwing slash
- taskwing mcp
- taskwing doctor
- taskwing config
- taskwing start
<!-- TASKWING_COMMANDS_END -->

### MCP Tools (Canonical Contract)

<!-- TASKWING_MCP_TOOLS_START -->
| Tool | Description |
|------|-------------|
| `ask` | Search project knowledge (decisions, patterns, constraints) |
| `task` | Unified task lifecycle (`next`, `current`, `start`, `complete`) |
| `plan` | Plan management (`clarify`, `decompose`, `expand`, `generate`, `finalize`, `audit`) |
| `code` | Code intelligence (`find`, `search`, `explain`, `callers`, `impact`, `simplify`) |
| `debug` | Diagnose issues systematically with AI-powered analysis |
| `remember` | Store knowledge in project memory |
| ask | Search project knowledge (decisions, patterns, constraints) |
| task | Unified task lifecycle (next, current, start, complete) |
| plan | Plan management (clarify, decompose, expand, generate, finalize, audit) |
| code | Code intelligence (find, search, explain, callers, impact, simplify) |
| debug | Diagnose issues systematically with AI-powered analysis |
| remember | Store knowledge in project memory |
<!-- TASKWING_MCP_TOOLS_END -->

### Autonomous Task Execution (Hooks)

TaskWing integrates with Claude Code's hook system for autonomous plan execution:

```bash
~~~bash
taskwing hook session-init # Initialize session tracking (SessionStart hook)
taskwing hook continue-check # Check if should continue to next task (Stop hook)
taskwing hook session-end # Cleanup session (SessionEnd hook)
taskwing hook status # View current session state
```
~~~

Circuit breakers prevent runaway execution:

- --max-tasks=5 stops after N tasks for human review.
- --max-minutes=30 stops after N minutes.

Expand Down
Loading
Loading