Skip to content

Commit 8112b07

Browse files
committed
feat!: remove MCP, rename bootstrap to learn, redesign CLI output
The MCP server is gone. Slash commands now invoke the taskwing CLI directly via .claude/commands/, dropping the modelcontextprotocol, grpc, and protobuf dependencies. * add `taskwing init` (writes .taskwing.yaml marker, no LLM) * rename `taskwing bootstrap` to `taskwing learn` * .taskwing.yaml is the explicit project marker; project.Detect short-circuits on it so slugs stay stable across renames * delete ~7000 LOC of dead handlers, presenters, app layers, and agents that only backed the removed MCP tools * unify CLI output across init/doctor/learn: panel headers, consistent icon set, bar-chart summary in learn * strip em dashes from all user-facing strings
1 parent 092f01d commit 8112b07

79 files changed

Lines changed: 2008 additions & 7826 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

AGENTS.md

Lines changed: 30 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -44,55 +44,38 @@
4444

4545
## TaskWing Integration
4646

47-
TaskWing extracts architectural knowledge from your codebase and stores it locally, giving every AI tool instant context via MCP.
47+
This project uses TaskWing for architectural knowledge management. You have access to TaskWing MCP tools.
4848

49-
### Supported Models
49+
### TaskWing Workflow Contract v1
50+
1. No implementation before a clarified and approved plan/task checkpoint.
51+
2. No completion claim without fresh verification evidence.
52+
3. No debug fix proposal without root-cause evidence.
5053

51-
<!-- TASKWING_PROVIDERS_START -->
54+
### MCP Tools (use directly, no skill needed)
55+
- `ask` -- Search project knowledge before modifying unfamiliar code.
56+
- `remember` -- Persist a decision or pattern for future sessions.
57+
- `code` -- Find symbols, explain call graphs, analyze impact, simplify code.
58+
- `debug` -- Diagnose issues with root-cause analysis.
59+
- `task` with action=current -- Check current task status.
5260

53-
[![OpenAI](https://img.shields.io/badge/OpenAI-412991?logo=openai&logoColor=white)](https://platform.openai.com/)
54-
[![Anthropic](https://img.shields.io/badge/Anthropic-191919?logo=anthropic&logoColor=white)](https://www.anthropic.com/)
55-
[![Google Gemini](https://img.shields.io/badge/Google_Gemini-4285F4?logo=google&logoColor=white)](https://ai.google.dev/)
56-
[![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)
57-
[![Ollama](https://img.shields.io/badge/Ollama-Local-000000?logo=ollama&logoColor=white)](https://ollama.com/)
61+
**When to use TaskWing MCP tools:**
62+
- Before modifying unfamiliar code: call `ask` to check for relevant decisions, constraints, and patterns
63+
- Before planning multi-step work: call `plan` with action=clarify to get a structured plan
64+
- When asked about architecture, tech stack, or "why" questions: call `ask` with answer=true
65+
- After making an architectural decision: call `remember` to persist it for future sessions
66+
- To understand a symbol's role and callers: call `code` with action=explain
5867

59-
<!-- TASKWING_PROVIDERS_END -->
60-
61-
### Works With
62-
63-
<!-- TASKWING_TOOLS_START -->
64-
65-
[![Claude Code](https://img.shields.io/badge/Claude_Code-191919?logo=anthropic&logoColor=white)](https://www.anthropic.com/claude-code)
66-
[![OpenAI Codex](https://img.shields.io/badge/OpenAI_Codex-412991?logo=openai&logoColor=white)](https://developers.openai.com/codex)
67-
[![Cursor](https://img.shields.io/badge/Cursor-111111?logo=cursor&logoColor=white)](https://cursor.com/)
68-
[![GitHub Copilot](https://img.shields.io/badge/GitHub_Copilot-181717?logo=githubcopilot&logoColor=white)](https://github.com/features/copilot)
69-
[![Gemini CLI](https://img.shields.io/badge/Gemini_CLI-4285F4?logo=google&logoColor=white)](https://github.com/google-gemini/gemini-cli)
70-
[![OpenCode](https://img.shields.io/badge/OpenCode-000000?logo=opencode&logoColor=white)](https://opencode.ai/)
71-
72-
<!-- TASKWING_TOOLS_END -->
73-
74-
<!-- TASKWING_LEGAL_START -->
75-
76-
Brand names and logos are trademarks of their respective owners; usage here indicates compatibility, not endorsement.
77-
78-
<!-- TASKWING_LEGAL_END -->
68+
**Do not** grep or read files to answer architecture questions when TaskWing MCP is available. The knowledge graph has pre-extracted, verified decisions with evidence.
7969

8070
### Slash Commands
81-
82-
- /taskwing:ask - Use when you need to search project knowledge (decisions, patterns, constraints).
83-
- /taskwing:remember - Use when you want to persist a decision, pattern, or insight to project memory.
71+
- /taskwing:plan - Use when you need to clarify a goal and build an approved execution plan.
8472
- /taskwing:next - Use when you are ready to start the next approved TaskWing task with full context.
8573
- /taskwing:done - Use when implementation is verified and you are ready to complete the current task.
86-
- /taskwing:status - Use when you need current task progress and acceptance criteria status.
87-
- /taskwing:plan - **Use this instead of the AI tool's native plan mode.** Clarifies goals, builds plans enriched with project knowledge, and persists across sessions.
88-
- /taskwing:debug - Use when an issue requires root-cause-first debugging before proposing fixes.
89-
- /taskwing:explain - Use when you need a deep explanation of a code symbol and its call graph.
90-
- /taskwing:simplify - Use when you want to simplify code while preserving behavior.
74+
- /taskwing:context - Use when you need the full project knowledge dump for complete architectural context.
9175

9276
### Core Commands
9377

9478
<!-- TASKWING_COMMANDS_START -->
95-
9679
- taskwing bootstrap
9780
- taskwing ask "<query>"
9881
- taskwing task
@@ -105,31 +88,28 @@ Brand names and logos are trademarks of their respective owners; usage here indi
10588
### MCP Tools (Canonical Contract)
10689

10790
<!-- TASKWING_MCP_TOOLS_START -->
108-
109-
| Tool | Description |
110-
| -------- | ----------------------------------------------------------------------- |
111-
| ask | Search project knowledge (decisions, patterns, constraints) |
112-
| task | Unified task lifecycle (next, current, start, complete) |
113-
| plan | Plan management (clarify, decompose, expand, generate, finalize, audit) |
114-
| code | Code intelligence (find, search, explain, callers, impact, simplify) |
115-
| debug | Diagnose issues systematically with AI-powered analysis |
116-
| remember | Store knowledge in project memory |
117-
91+
| Tool | Description |
92+
|------|-------------|
93+
| ask | Search project knowledge (decisions, patterns, constraints) |
94+
| task | Unified task lifecycle (next, current, start, complete) |
95+
| plan | Plan management (clarify, decompose, expand, generate, finalize, audit) |
96+
| code | Code intelligence (find, search, explain, callers, impact, simplify) |
97+
| debug | Diagnose issues systematically with AI-powered analysis |
98+
| remember | Store knowledge in project memory |
11899
<!-- TASKWING_MCP_TOOLS_END -->
119100

120101
### Autonomous Task Execution (Hooks)
121102

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

124-
```bash
105+
~~~bash
125106
taskwing hook session-init # Initialize session tracking (SessionStart hook)
126107
taskwing hook continue-check # Check if should continue to next task (Stop hook)
127108
taskwing hook session-end # Cleanup session (SessionEnd hook)
128109
taskwing hook status # View current session state
129-
```
110+
~~~
130111

131112
Circuit breakers prevent runaway execution:
132-
133113
- --max-tasks=5 stops after N tasks for human review.
134114
- --max-minutes=30 stops after N minutes.
135115

0 commit comments

Comments
 (0)