drawbore 0.1.0 → 0.1.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/CHANGELOG.md +28 -20
- package/LICENSE +20 -20
- package/README.md +75 -75
- package/bin/drawbore.js +334 -266
- package/lib/checker.js +398 -398
- package/lib/index.js +3 -1
- package/lib/installer.js +404 -404
- package/lib/prompts.js +375 -373
- package/package.json +42 -42
- package/skills/discover/SKILL.md +76 -76
- package/skills/frame/SKILL.md +84 -84
- package/skills/frame/references/change-brief.md +54 -54
- package/skills/init-project/SKILL.md +85 -85
- package/skills/recall/SKILL.md +61 -61
- package/skills/record/SKILL.md +98 -98
- package/skills/record/references/artifact-formats.md +130 -130
- package/skills/release/SKILL.md +107 -107
- package/skills/review/SKILL.md +116 -116
- package/templates/instruction.md +8 -8
- package/templates/manifest.json +11 -11
- package/templates/record/context.md +13 -13
- package/templates/record/glossary.md +6 -6
- package/templates/record/index.md +15 -15
- package/templates/record/principles.md +2 -2
- package/templates/record/stack.md +6 -6
- package/templates/record/system.md +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,21 +1,29 @@
|
|
|
1
|
-
# Changelog
|
|
2
|
-
|
|
3
|
-
All notable changes to this project are documented in this file.
|
|
4
|
-
|
|
5
|
-
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
6
|
-
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
|
-
|
|
8
|
-
## [
|
|
9
|
-
|
|
10
|
-
###
|
|
11
|
-
|
|
12
|
-
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
###
|
|
19
|
-
|
|
20
|
-
-
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to this project are documented in this file.
|
|
4
|
+
|
|
5
|
+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
6
|
+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
|
+
|
|
8
|
+
## [0.1.1] - 2026-11-16
|
|
9
|
+
|
|
10
|
+
### Fixed
|
|
11
|
+
|
|
12
|
+
- `drawbore init` with no flags now runs the interactive installer: checkbox prompts for harness locations, notebook creation, instruction files, and a final confirmation. The prompt layer existed in `lib/prompts.js` but was never wired into the CLI, so a bare `init` silently installed hardcoded defaults. Non-TTY streams (CI, pipes) still use the defaults without prompting.
|
|
13
|
+
|
|
14
|
+
## [0.1.0] - 2026-11-16
|
|
15
|
+
|
|
16
|
+
Published to npm as `drawbore@0.1.0` (bootstrap publish; the first staged release is next).
|
|
17
|
+
|
|
18
|
+
### Added
|
|
19
|
+
|
|
20
|
+
- Consent-aware installer for `.agents`, `.claude`, `.codex`, `.cursor`, `.omp`, and `.opencode`.
|
|
21
|
+
- `.drawbore/` notebook templates and a structural checker.
|
|
22
|
+
- `drawbore init` and `drawbore check` CLI commands.
|
|
23
|
+
- Seven portable skills: `discover`, `recall`, `frame`, `record`, `review`, `init-project`, and `release`.
|
|
24
|
+
- `init-project` generates a release pipeline from the project's answers — publish mode, build steps, and provider — instead of copying a template, and records the result in the root `AGENTS.md` under `publish mode` and `pipeline`.
|
|
25
|
+
|
|
26
|
+
### Changed
|
|
27
|
+
|
|
28
|
+
- Skill conflicts are decided by content rather than by name. A skill directory is foreign only when its contents diverge from what the package ships; a file/directory mismatch is preserved instead of blocking the install.
|
|
21
29
|
- `release` branches on `publish mode` and `pipeline`, reading them from `AGENTS.md`. Sections written before those fields existed are still handled: the mode is inferred from the prose and the CI file, and the package field is read as either `package` or `npm package`.
|
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 Arthur Biazon Machado
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Arthur Biazon Machado
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
21
|
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,76 +1,76 @@
|
|
|
1
|
-
# Drawbore
|
|
2
|
-
|
|
3
|
-
[](https://gitlab.com/abmach/drawbore/-/pipelines)
|
|
4
|
-
|
|
5
|
-
**You code. It holds.**
|
|
6
|
-
|
|
7
|
-
Durable context for AI-assisted software development.
|
|
8
|
-
|
|
9
|
-
Drawbore adds repository-aware context, engineering rules, and portable agent workflows on top of the repository and harness you already use. It adapts to the project rather than replacing the agent, the harness, or the repository’s own structure.
|
|
10
|
-
|
|
11
|
-
## Status
|
|
12
|
-
|
|
13
|
-
The installer, notebook templates, structural checker, and portable skills are implemented.
|
|
14
|
-
|
|
15
|
-
## What it provides
|
|
16
|
-
|
|
17
|
-
- **Durable context** — a `.drawbore/` containing purpose, scope, architecture, glossary, principles, decisions, current behavior, and technical choices.
|
|
18
|
-
- **Portable skills** — `discover`, `recall`, `frame`, `record`, `review`, `init-project`, and `release`.
|
|
19
|
-
- **Structural checks** — duplicate decision IDs, broken supersession, invalid records, missing headings, and stale-candidate warnings.
|
|
20
|
-
- **Consent-aware installation** — no file is overwritten without an explicit choice; locally modified skills are preserved.
|
|
21
|
-
- **Provider-neutral operation** — no forge, registry, or CI provider is assumed.
|
|
22
|
-
|
|
23
|
-
## Install
|
|
24
|
-
|
|
25
|
-
```sh
|
|
26
|
-
npx drawbore init
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
The installer asks which harness locations should receive the skills, whether to create `.drawbore/`, and which instruction file should carry the Drawbore block. In non-interactive environments, use explicit flags:
|
|
30
|
-
|
|
31
|
-
```sh
|
|
32
|
-
npx drawbore init --location .agents --notebook --instruction AGENTS.md --yes
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
### Supported locations
|
|
36
|
-
|
|
37
|
-
`.agents`, `.claude`, `.codex`, `.cursor`, `.omp`, `.opencode`
|
|
38
|
-
|
|
39
|
-
Each location receives its skills under `<location>/skills/`. The instruction file is selected from `AGENTS.md` or `CLAUDE.md`.
|
|
40
|
-
|
|
41
|
-
## Check the notebook
|
|
42
|
-
|
|
43
|
-
```sh
|
|
44
|
-
npx drawbore check
|
|
45
|
-
npx drawbore check --json
|
|
46
|
-
npx drawbore check --fix
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
`check` is read-only unless `--fix` is passed. `--fix` only aligns decision IDs to filenames and renumbers duplicates; it never rewrites record bodies.
|
|
50
|
-
|
|
51
|
-
## Skills
|
|
52
|
-
|
|
53
|
-
| Skill | Role |
|
|
54
|
-
|---|---|
|
|
55
|
-
| `discover` | Analyze an existing repository and propose its initial durable context |
|
|
56
|
-
| `recall` | Consult durable context before work and reconcile the implementation afterward |
|
|
57
|
-
| `frame` | Shape scope and maintain a Change Brief before implementation |
|
|
58
|
-
| `record` | Record confirmed terms, principles, decisions, behavior, and technical choices |
|
|
59
|
-
| `review` | Analyze a repository and propose a ranked plan, then implement only the approved items |
|
|
60
|
-
| `init-project` | Scaffold a provider-neutral project, including its release pipeline |
|
|
61
|
-
| `release` | Run a provider-neutral release flow |
|
|
62
|
-
|
|
63
|
-
## Repository
|
|
64
|
-
|
|
65
|
-
This repository is canonical on GitLab. GitHub is a read-only distribution mirror: issues and releases live on GitLab.
|
|
66
|
-
|
|
67
|
-
## Development
|
|
68
|
-
|
|
69
|
-
```sh
|
|
70
|
-
npm install
|
|
71
|
-
npm test
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
## License
|
|
75
|
-
|
|
1
|
+
# Drawbore
|
|
2
|
+
|
|
3
|
+
[](https://gitlab.com/abmach/drawbore/-/pipelines)
|
|
4
|
+
|
|
5
|
+
**You code. It holds.**
|
|
6
|
+
|
|
7
|
+
Durable context for AI-assisted software development.
|
|
8
|
+
|
|
9
|
+
Drawbore adds repository-aware context, engineering rules, and portable agent workflows on top of the repository and harness you already use. It adapts to the project rather than replacing the agent, the harness, or the repository’s own structure.
|
|
10
|
+
|
|
11
|
+
## Status
|
|
12
|
+
|
|
13
|
+
The installer, notebook templates, structural checker, and portable skills are implemented.
|
|
14
|
+
|
|
15
|
+
## What it provides
|
|
16
|
+
|
|
17
|
+
- **Durable context** — a `.drawbore/` containing purpose, scope, architecture, glossary, principles, decisions, current behavior, and technical choices.
|
|
18
|
+
- **Portable skills** — `discover`, `recall`, `frame`, `record`, `review`, `init-project`, and `release`.
|
|
19
|
+
- **Structural checks** — duplicate decision IDs, broken supersession, invalid records, missing headings, and stale-candidate warnings.
|
|
20
|
+
- **Consent-aware installation** — no file is overwritten without an explicit choice; locally modified skills are preserved.
|
|
21
|
+
- **Provider-neutral operation** — no forge, registry, or CI provider is assumed.
|
|
22
|
+
|
|
23
|
+
## Install
|
|
24
|
+
|
|
25
|
+
```sh
|
|
26
|
+
npx drawbore init
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
The installer asks which harness locations should receive the skills, whether to create `.drawbore/`, and which instruction file should carry the Drawbore block. In non-interactive environments, use explicit flags:
|
|
30
|
+
|
|
31
|
+
```sh
|
|
32
|
+
npx drawbore init --location .agents --notebook --instruction AGENTS.md --yes
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
### Supported locations
|
|
36
|
+
|
|
37
|
+
`.agents`, `.claude`, `.codex`, `.cursor`, `.omp`, `.opencode`
|
|
38
|
+
|
|
39
|
+
Each location receives its skills under `<location>/skills/`. The instruction file is selected from `AGENTS.md` or `CLAUDE.md`.
|
|
40
|
+
|
|
41
|
+
## Check the notebook
|
|
42
|
+
|
|
43
|
+
```sh
|
|
44
|
+
npx drawbore check
|
|
45
|
+
npx drawbore check --json
|
|
46
|
+
npx drawbore check --fix
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
`check` is read-only unless `--fix` is passed. `--fix` only aligns decision IDs to filenames and renumbers duplicates; it never rewrites record bodies.
|
|
50
|
+
|
|
51
|
+
## Skills
|
|
52
|
+
|
|
53
|
+
| Skill | Role |
|
|
54
|
+
|---|---|
|
|
55
|
+
| `discover` | Analyze an existing repository and propose its initial durable context |
|
|
56
|
+
| `recall` | Consult durable context before work and reconcile the implementation afterward |
|
|
57
|
+
| `frame` | Shape scope and maintain a Change Brief before implementation |
|
|
58
|
+
| `record` | Record confirmed terms, principles, decisions, behavior, and technical choices |
|
|
59
|
+
| `review` | Analyze a repository and propose a ranked plan, then implement only the approved items |
|
|
60
|
+
| `init-project` | Scaffold a provider-neutral project, including its release pipeline |
|
|
61
|
+
| `release` | Run a provider-neutral release flow |
|
|
62
|
+
|
|
63
|
+
## Repository
|
|
64
|
+
|
|
65
|
+
This repository is canonical on GitLab. GitHub is a read-only distribution mirror: issues and releases live on GitLab.
|
|
66
|
+
|
|
67
|
+
## Development
|
|
68
|
+
|
|
69
|
+
```sh
|
|
70
|
+
npm install
|
|
71
|
+
npm test
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
## License
|
|
75
|
+
|
|
76
76
|
MIT
|