specrails-core 3.5.0 → 3.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/commands/setup.md +3 -3
- package/docs/installation.md +1 -1
- package/docs/local-tickets.md +4 -4
- package/docs/migration-guide.md +2 -2
- package/docs/workflows.md +1 -1
- package/package.json +1 -1
- package/templates/commands/specrails/setup.md +3 -3
package/README.md
CHANGED
|
@@ -196,7 +196,7 @@ AI product discovery using your personas. Evaluates ideas, creates tickets (loca
|
|
|
196
196
|
|
|
197
197
|
specrails-core ships with a built-in ticket system — no GitHub account or external tools required.
|
|
198
198
|
|
|
199
|
-
Tickets live in `.
|
|
199
|
+
Tickets live in `.specrails/local-tickets.json` alongside your code. They're plain JSON and git-friendly.
|
|
200
200
|
|
|
201
201
|
**Local tickets are the default.** The `/specrails:setup` wizard defaults to local tickets and skips GitHub/JIRA credential setup unless you opt in.
|
|
202
202
|
|
package/commands/setup.md
CHANGED
|
@@ -699,7 +699,7 @@ Ask the user how they want to manage their product backlog. Default is local —
|
|
|
699
699
|
Use local ticket management or connect an external provider?
|
|
700
700
|
|
|
701
701
|
1. **Local tickets** (default, recommended) — lightweight JSON-based ticket management built into the project.
|
|
702
|
-
No external tools or accounts required. Tickets stored in `.
|
|
702
|
+
No external tools or accounts required. Tickets stored in `.specrails/local-tickets.json`, version-controlled and diffable.
|
|
703
703
|
2. **External provider** — connect GitHub Issues, JIRA, or disable backlog commands
|
|
704
704
|
```
|
|
705
705
|
|
|
@@ -713,7 +713,7 @@ If the user selects **2**: display the secondary menu:
|
|
|
713
713
|
Which external provider?
|
|
714
714
|
|
|
715
715
|
1. **Local tickets** (recommended) — lightweight JSON-based ticket management built into the project.
|
|
716
|
-
No external tools required. Tickets stored in `.
|
|
716
|
+
No external tools required. Tickets stored in `.specrails/local-tickets.json`, version-controlled and diffable.
|
|
717
717
|
2. **GitHub Issues** — uses `gh` CLI to read/create issues with labels and VPC scores
|
|
718
718
|
3. **JIRA** — uses JIRA CLI or REST API to read/create tickets in a JIRA project
|
|
719
719
|
4. **None** — skip backlog commands (you can still use /implement with text descriptions)
|
|
@@ -895,7 +895,7 @@ Ask:
|
|
|
895
895
|
|
|
896
896
|
Set `EPIC_LINK_FIELD` to `parent` or `customfield_10014`. Default: `parent`.
|
|
897
897
|
|
|
898
|
-
Store the full configuration in `.
|
|
898
|
+
Store the full configuration in `.specrails/backlog-config.json`:
|
|
899
899
|
```json
|
|
900
900
|
{
|
|
901
901
|
"provider": "jira",
|
package/docs/installation.md
CHANGED
|
@@ -231,7 +231,7 @@ The quick path — three questions, sensible defaults, done in under a minute.
|
|
|
231
231
|
|------|--------|
|
|
232
232
|
| Core agents | sr-architect, sr-developer, sr-reviewer, sr-product-manager |
|
|
233
233
|
| All workflow commands | `/specrails:implement`, `/specrails:get-backlog-specs`, and 14 more |
|
|
234
|
-
| Backlog storage | Local tickets (`.
|
|
234
|
+
| Backlog storage | Local tickets (`.specrails/local-tickets.json`) — no GitHub or JIRA required |
|
|
235
235
|
| CLAUDE.md | Project-level context for agents |
|
|
236
236
|
|
|
237
237
|
You can run the full wizard later to deepen configuration: personas, stack analysis, layer-specific conventions.
|
package/docs/local-tickets.md
CHANGED
|
@@ -6,7 +6,7 @@ specrails-core ships with a built-in, file-based ticket management system. It is
|
|
|
6
6
|
|
|
7
7
|
## Overview
|
|
8
8
|
|
|
9
|
-
Tickets live in `.
|
|
9
|
+
Tickets live in `.specrails/local-tickets.json` at your project root. Because it's a plain JSON file, tickets are:
|
|
10
10
|
|
|
11
11
|
- **Version-controlled** — tracked by git, diffable in PRs
|
|
12
12
|
- **Offline-first** — no network calls, no rate limits
|
|
@@ -18,7 +18,7 @@ The file is read and written by specrails-core during command execution.
|
|
|
18
18
|
|
|
19
19
|
## Storage format
|
|
20
20
|
|
|
21
|
-
`.
|
|
21
|
+
`.specrails/local-tickets.json`:
|
|
22
22
|
|
|
23
23
|
```json
|
|
24
24
|
{
|
|
@@ -99,7 +99,7 @@ Use local ticket management or connect an external provider?
|
|
|
99
99
|
2. External provider — connect GitHub Issues, JIRA, or disable backlog commands
|
|
100
100
|
```
|
|
101
101
|
|
|
102
|
-
Pressing **Enter** or selecting **1** initializes `.
|
|
102
|
+
Pressing **Enter** or selecting **1** initializes `.specrails/local-tickets.json` with an empty ticket store and writes `.specrails/backlog-config.json`:
|
|
103
103
|
|
|
104
104
|
```json
|
|
105
105
|
{
|
|
@@ -123,7 +123,7 @@ Multiple agents can modify `local-tickets.json` simultaneously. The system uses
|
|
|
123
123
|
|
|
124
124
|
### Advisory file lock
|
|
125
125
|
|
|
126
|
-
Before every write, the agent creates `.
|
|
126
|
+
Before every write, the agent creates `.specrails/local-tickets.json.lock`:
|
|
127
127
|
|
|
128
128
|
```json
|
|
129
129
|
{
|
package/docs/migration-guide.md
CHANGED
|
@@ -22,7 +22,7 @@ Switching is optional. GitHub Issues and JIRA remain fully supported. Local tick
|
|
|
22
22
|
|
|
23
23
|
## Step 1: Switch the provider
|
|
24
24
|
|
|
25
|
-
Edit `.
|
|
25
|
+
Edit `.specrails/backlog-config.json` in your project root:
|
|
26
26
|
|
|
27
27
|
```json
|
|
28
28
|
{
|
|
@@ -42,7 +42,7 @@ Then initialize the ticket store if it doesn't exist yet:
|
|
|
42
42
|
Or create the file manually:
|
|
43
43
|
|
|
44
44
|
```bash
|
|
45
|
-
cat > .
|
|
45
|
+
cat > .specrails/local-tickets.json << 'EOF'
|
|
46
46
|
{
|
|
47
47
|
"schema_version": "1.0",
|
|
48
48
|
"revision": 0,
|
package/docs/workflows.md
CHANGED
|
@@ -126,7 +126,7 @@ View your prioritized product backlog, ranked by VPC fit and effort.
|
|
|
126
126
|
|
|
127
127
|
### What it shows
|
|
128
128
|
|
|
129
|
-
The Product Analyst reads your backlog (local tickets in `.
|
|
129
|
+
The Product Analyst reads your backlog (local tickets in `.specrails/local-tickets.json` by default, or GitHub Issues labeled `product-driven-backlog` if configured) and produces:
|
|
130
130
|
|
|
131
131
|
- **Backlog table** per area — sorted by Total Persona Score
|
|
132
132
|
- **Top 3 recommendations** — ranked by VPC score / effort ratio, filtered to Wave 1 of the safe implementation order
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "specrails-core",
|
|
3
|
-
"version": "3.5.
|
|
3
|
+
"version": "3.5.1",
|
|
4
4
|
"description": "AI agent workflow system for Claude Code — installs 12 specialized agents, orchestration commands, and persona-driven product discovery into any repository",
|
|
5
5
|
"bin": {
|
|
6
6
|
"specrails-core": "bin/specrails-core.js"
|
|
@@ -699,7 +699,7 @@ Ask the user how they want to manage their product backlog. Default is local —
|
|
|
699
699
|
Use local ticket management or connect an external provider?
|
|
700
700
|
|
|
701
701
|
1. **Local tickets** (default, recommended) — lightweight JSON-based ticket management built into the project.
|
|
702
|
-
No external tools or accounts required. Tickets stored in `.
|
|
702
|
+
No external tools or accounts required. Tickets stored in `.specrails/local-tickets.json`, version-controlled and diffable.
|
|
703
703
|
2. **External provider** — connect GitHub Issues, JIRA, or disable backlog commands
|
|
704
704
|
```
|
|
705
705
|
|
|
@@ -713,7 +713,7 @@ If the user selects **2**: display the secondary menu:
|
|
|
713
713
|
Which external provider?
|
|
714
714
|
|
|
715
715
|
1. **Local tickets** (recommended) — lightweight JSON-based ticket management built into the project.
|
|
716
|
-
No external tools required. Tickets stored in `.
|
|
716
|
+
No external tools required. Tickets stored in `.specrails/local-tickets.json`, version-controlled and diffable.
|
|
717
717
|
2. **GitHub Issues** — uses `gh` CLI to read/create issues with labels and VPC scores
|
|
718
718
|
3. **JIRA** — uses JIRA CLI or REST API to read/create tickets in a JIRA project
|
|
719
719
|
4. **None** — skip backlog commands (you can still use /implement with text descriptions)
|
|
@@ -895,7 +895,7 @@ Ask:
|
|
|
895
895
|
|
|
896
896
|
Set `EPIC_LINK_FIELD` to `parent` or `customfield_10014`. Default: `parent`.
|
|
897
897
|
|
|
898
|
-
Store the full configuration in `.
|
|
898
|
+
Store the full configuration in `.specrails/backlog-config.json`:
|
|
899
899
|
```json
|
|
900
900
|
{
|
|
901
901
|
"provider": "jira",
|