@accord-dev/accord 0.8.0 → 0.8.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 +10 -10
- package/dist/cli.js +955 -111
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -8,7 +8,7 @@ Accord adds a small, fixed folder to your repository. Before an agent writes cod
|
|
|
8
8
|
|
|
9
9
|
BA, designer, developer and reviewer are four stages a ticket passes through, not four job titles. One person can pass through all four, or four people on a team can divide them. No gate reads who anyone is, so the same rules hold either way.
|
|
10
10
|
|
|
11
|
-
Released: `@accord-dev/accord@0.8.
|
|
11
|
+
Released: `@accord-dev/accord@0.8.1` on npm. See [docs/design.md](https://github.com/ngothanhluan/accord/blob/main/docs/design.md) for the design and the reasoning behind it.
|
|
12
12
|
|
|
13
13
|
## The problem
|
|
14
14
|
|
|
@@ -37,13 +37,13 @@ AI coding agents produce features that pass their own tests and still miss what
|
|
|
37
37
|
Node 22.12 or newer. Run accord through npx with an exact version, so nothing needs installing:
|
|
38
38
|
|
|
39
39
|
```sh
|
|
40
|
-
npx --yes @accord-dev/accord@0.8.
|
|
40
|
+
npx --yes @accord-dev/accord@0.8.1 <command>
|
|
41
41
|
```
|
|
42
42
|
|
|
43
43
|
Or install it globally and run `accord <command>`:
|
|
44
44
|
|
|
45
45
|
```sh
|
|
46
|
-
npm i -g @accord-dev/accord@0.8.
|
|
46
|
+
npm i -g @accord-dev/accord@0.8.1
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
The global install must be the same version the repository pins (see [Version pin](#8-version-pin-and-upgrading)).
|
|
@@ -53,7 +53,7 @@ The global install must be the same version the repository pins (see [Version pi
|
|
|
53
53
|
In the repository root:
|
|
54
54
|
|
|
55
55
|
```sh
|
|
56
|
-
npx --yes @accord-dev/accord@0.8.
|
|
56
|
+
npx --yes @accord-dev/accord@0.8.1 init
|
|
57
57
|
```
|
|
58
58
|
|
|
59
59
|
`init` asks nothing and takes no options. It never overwrites `accord/config.yml`, the product files or the workflow when they exist. The skill, agent and pane copies are accord's own and are rewritten to this version, and the hooks are merged into existing settings. Each path is printed as `created`, `skipped`, `appended`, `updated`, `unchanged` or `overwrote local edits`. It writes:
|
|
@@ -76,7 +76,7 @@ git commit -m "accord init"
|
|
|
76
76
|
git push
|
|
77
77
|
```
|
|
78
78
|
|
|
79
|
-
Teammates get the same skills, hooks and pane by pulling. The skills run a bare `accord` command. In Claude Code, the session hook tells the agent to run it through `npx` at the pinned version when `accord` is not on PATH. In Codex, Cursor and Copilot there is no such hook, so each person installs the pinned version globally (`npm i -g @accord-dev/accord@0.8.
|
|
79
|
+
Teammates get the same skills, hooks and pane by pulling. The skills run a bare `accord` command. In Claude Code, the session hook tells the agent to run it through `npx` at the pinned version when `accord` is not on PATH. In Codex, Cursor and Copilot there is no such hook, so each person installs the pinned version globally (`npm i -g @accord-dev/accord@0.8.1`).
|
|
80
80
|
|
|
81
81
|
### 4. Make the accord check a merge gate
|
|
82
82
|
|
|
@@ -130,14 +130,14 @@ In Claude Code, the pane shows the dashboard beside the chat.
|
|
|
130
130
|
After you change `runtimes:`, write the copies again and commit what it prints:
|
|
131
131
|
|
|
132
132
|
```sh
|
|
133
|
-
npx --yes @accord-dev/accord@0.8.
|
|
133
|
+
npx --yes @accord-dev/accord@0.8.1 skills sync
|
|
134
134
|
```
|
|
135
135
|
|
|
136
136
|
`skills sync` deletes no copy you may still use. When you remove a runtime, it lists the copies it no longer writes, and you delete them yourself. The one file it deletes is `.claude/agents/accord-architect.md`, an agent accord no longer has, and only while its marker shows nobody edited it: it prints `removed` for it, and lists an edited copy with the others.
|
|
137
137
|
|
|
138
138
|
### 7. CLI commands for people and CI
|
|
139
139
|
|
|
140
|
-
The skills call the CLI for you. These are the commands most useful to run by hand or in CI. Bare `accord` needs the global install at the pinned version; without it, put `npx --yes @accord-dev/accord@0.8.
|
|
140
|
+
The skills call the CLI for you. These are the commands most useful to run by hand or in CI. Bare `accord` needs the global install at the pinned version; without it, put `npx --yes @accord-dev/accord@0.8.1` in place of `accord`. Run `accord --help` for the full list, and `accord <command> --help` for each one.
|
|
141
141
|
|
|
142
142
|
| Command | What it does |
|
|
143
143
|
|---|---|
|
|
@@ -159,15 +159,15 @@ The skills call the CLI for you. These are the commands most useful to run by ha
|
|
|
159
159
|
|
|
160
160
|
### 8. Version pin and upgrading
|
|
161
161
|
|
|
162
|
-
`accord/config.yml` pins an exact version in its `accord:` key, and the CI workflow and Claude Code hooks use the same one. Every command that reads the repository refuses with exit 2 when the running version differs (on a version mismatch the `prompt-expansion` and `pre-tool-use` hooks only warn, so the prompt or the agent dispatch goes on), and names the command to run instead, with the pinned version in place of 0.8.
|
|
162
|
+
`accord/config.yml` pins an exact version in its `accord:` key, and the CI workflow and Claude Code hooks use the same one. Every command that reads the repository refuses with exit 2 when the running version differs (on a version mismatch the `prompt-expansion` and `pre-tool-use` hooks only warn, so the prompt or the agent dispatch goes on), and names the command to run instead, with the pinned version in place of 0.8.1:
|
|
163
163
|
|
|
164
164
|
```sh
|
|
165
|
-
npx --yes @accord-dev/accord@0.8.
|
|
165
|
+
npx --yes @accord-dev/accord@0.8.1 <command>
|
|
166
166
|
```
|
|
167
167
|
|
|
168
168
|
There is no flag or environment variable that skips the check. Only `--version`, `--help` and `upgrade` run regardless.
|
|
169
169
|
|
|
170
|
-
`/accord` says when a newer release is out. `/accord-upgrade` runs `upgrade` as the newer version, which pushes a branch `upgrade/<version>` from the remote default branch with one commit that moves the pin and regenerates the skill files. Your checkout is not touched; merge the pull request to upgrade. A repository still pinned to 0.1.0 runs `npx --yes @accord-dev/accord@0.8.
|
|
170
|
+
`/accord` says when a newer release is out. `/accord-upgrade` runs `upgrade` as the newer version, which pushes a branch `upgrade/<version>` from the remote default branch with one commit that moves the pin and regenerates the skill files. Your checkout is not touched; merge the pull request to upgrade. A repository still pinned to 0.1.0 runs `npx --yes @accord-dev/accord@0.8.1 upgrade` once by hand.
|
|
171
171
|
|
|
172
172
|
Exit codes:
|
|
173
173
|
|