Skip to content

docs(claude-md): remove stale IMPLEMENTATION_PLAN.md ref and soften OpenSpec language #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Aaronontheweb merged 1 commit into from
May 25, 2026
Merged

docs(claude-md): remove stale IMPLEMENTATION_PLAN.md ref and soften OpenSpec language #2

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
17 changes: 9 additions & 8 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,6 @@ Read first:

- `PROJECT_CONTEXT.md`
- `TOOLING.md`
- `IMPLEMENTATION_PLAN.md`
- `docs/prd/README.md`
- `.opencode/skills/netclaw-*/SKILL.md`
- `.claude/skills/ralph-*.md`
Expand Down Expand Up @@ -51,11 +50,13 @@ Expected outputs:
- matching spec updates when behavior changes
- no undocumented behavior drift

## OpenSpec Workflow (MANDATORY)
## OpenSpec Workflow

**You MUST use OpenSpec skills for all planning and spec work.** Do not manually
create or edit OpenSpec artifacts (specs, changes, proposals, delta specs,
design docs, task files). Use the skills listed below.
Use OpenSpec skills for substantial planning and spec work — new features,
capability additions, or changes that touch multiple components. Skip it for
targeted bug fixes, small refactors, and changes where scope is already clear.
Do not manually create or edit OpenSpec artifacts (specs, changes, proposals,
delta specs, design docs, task files); use the skills below instead.

### When Planning (new feature, capability, or spec change)

Expand All @@ -79,9 +80,9 @@ design docs, task files). Use the skills listed below.
- `/opsx-onboard` — guided walkthrough of the full OpenSpec workflow
- `/opsx-bulk-archive` — archive multiple completed changes

**Hard rule:** If you need to create or modify files under `openspec/`, use the
appropriate skill above. The only exception is updating task checkboxes in
`openspec/changes/*/tasks.md` during RALPH iterations.
If you do need to create or modify files under `openspec/`, use the appropriate
skill above rather than editing them directly. The only exception is updating
task checkboxes in `openspec/changes/*/tasks.md` during RALPH iterations.

## Discovery Rules

Expand Down
Loading