Skip to content
Merged
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
2 changes: 1 addition & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ SpecSync uses OpenSpec and itself (dogfooding) to manage development.
- **Implementation**: Changes reference GitHub issues synced by specsync
- **Dogfooding**: This repo dogfoods specsync; every issue is spec-generated
- **CI gates**: Changelog linking, archive hygiene, task accuracy enforced
- **Agent tools**: `specsync agent-help`, `specsync doctor`, `specsync changes --json`
- **Agent tools**: `specsync agent-help`, `specsync doctor`, `specsync changes -json`

## Where to Go Next

Expand Down
18 changes: 1 addition & 17 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -104,7 +104,6 @@ specsync [sync] # project changes -> issues (default command)
specsync pull # pull an issue into a local change
specsync scan # what already exists in an area?
specsync trace # print the raw spec<->commit<->issue link graph
specsync relate # print the work graph around a change
specsync link # cross-link two or more changes
specsync spinoff # spawn emergent work as a linked sibling
specsync epic # create a coordination issue and wire children
Expand Down Expand Up @@ -471,7 +470,7 @@ See what you've captured that nobody has triaged yet:

```bash
specsync ideas # table output, oldest first
specsync ideas --json # JSON for scripting
specsync ideas -json # JSON for scripting
```

### Triage: pull → triage → act
Expand All @@ -492,21 +491,6 @@ specsync trace -change my-feature # scope to one change
specsync trace -since v0.3.0 -json # commits since a tag, as JSON
```

### `relate` — the work graph for planning

Prints the connected slice around a change: related specs (via `links.md`),
their issues, linked PRs, merge commits, and releases. Built on the
**asserted-graph principle**: every edge is authored in `links.md`/markers or
read as fact from `git`/`gh` — never inferred or probabilistic.

```bash
specsync relate -change my-feature # graph around one change
specsync relate -path src/auth.ts # changes touching a file
```

Read-only: never writes to disk or the tracker. Supports delta annotations
when `openspec` is on PATH (tags spec nodes with ADDED/MODIFIED/REMOVED counts).

**Non-goals** (parked for future changes):
- **`graph.json` export** — no consumer exists yet
- **Graphify / inferred edges** — code-symbol edges would pollute an asserted graph
Expand Down
2 changes: 1 addition & 1 deletion WORKFLOW.md
Original file line number Diff line number Diff line change
Expand Up @@ -223,7 +223,7 @@ If `specsync verify` warns about a PR missing a reference, add one before mergin

This should not happen. If it does:
1. Check if `.specsync/board.json` exists and is readable
2. Verify human-move detection ran: `specsync sync --dry-run` should show StatusSkipped
2. Verify human-move detection ran: `specsync sync -dry-run` should show StatusSkipped
3. If not skipping, the prior base state may be stale; delete `.specsync/board.json` and re-sync

### "My priority/stage isn't being used"
Expand Down
Loading
Loading