Skip to content

Commit 5fab22e

Browse files
committed
docs: add motivation section to README referencing issue #8324
1 parent d5afe66 commit 5fab22e

1 file changed

Lines changed: 13 additions & 0 deletions

File tree

README.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,19 @@
22

33
An OpenCode plugin that integrates OpenSpec, providing a dedicated agent for planning and specifying software architecture.
44

5+
## Motivation
6+
7+
This plugin addresses the need for a dedicated planning mode in OpenCode, as discussed in [Issue #8324](https://github.com/anomalyco/opencode/issues/8324).
8+
9+
**The Problem:**
10+
When using OpenCode's standard "Build mode" to create or modify OpenSpec planning documents, AI agents often attempt to start implementing code changes immediately, before the planning phase is complete. This can lead to premature coding and a lack of focus on the architectural design.
11+
12+
**The Solution:**
13+
`opencode-plugin-openspec` introduces a specialized **OpenSpec Architect** agent. This agent is configured to:
14+
* **Allow** creating and editing OpenSpec documents (e.g., `project.md`, `specs/**`).
15+
* **Prevent** modifications to the implementation code.
16+
* **Focus** entirely on planning and specification, ensuring a clear separation between design and implementation.
17+
518
## Features
619

720
- **Auto-Detection**: Automatically detects if the current workspace is an OpenSpec project.

0 commit comments

Comments
 (0)