project-tiny-context-harness 0.2.39 → 0.2.40
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 +5 -5
- package/assets/README.md +12 -18
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Project Tiny Context Harness
|
|
2
2
|
|
|
3
|
-
[](https://www.npmjs.com/package/project-tiny-context-harness)
|
|
4
4
|
[](https://github.com/Seven128/project-tiny-context-harness/actions/workflows/package.yml)
|
|
5
5
|
[](https://securityscorecards.dev/viewer/?uri=github.com/Seven128/project-tiny-context-harness)
|
|
6
6
|
[](LICENSE)
|
|
@@ -51,7 +51,7 @@ flowchart LR
|
|
|
51
51
|
|
|
52
52
|
|
|
53
53
|
|
|
54
|
-
The demo shows the core loop: initialize `AGENTS.md` and `project_context/**`, run `validate-context`, then ask a fresh agent to recover intent before proposing code.
|
|
54
|
+
The demo shows the core loop: initialize `AGENTS.md` and `project_context/**`, run `validate-context`, then ask a fresh agent to recover intent before proposing code. Use the npm install path below, or inspect the no-install previews first.
|
|
55
55
|
|
|
56
56
|
No-install preview:
|
|
57
57
|
|
|
@@ -91,7 +91,7 @@ make validate-context
|
|
|
91
91
|
|
|
92
92
|
Then open `AGENTS.md`, `project_context/global.md` and `project_context/architecture.md`. Those files are the small recovery surface a fresh agent should read before changing the project.
|
|
93
93
|
|
|
94
|
-
Source preview
|
|
94
|
+
Source checkout preview:
|
|
95
95
|
|
|
96
96
|
Browser preview:
|
|
97
97
|
|
|
@@ -115,12 +115,12 @@ npm ci
|
|
|
115
115
|
npm run smoke:quickstart
|
|
116
116
|
npm run preview:pack
|
|
117
117
|
cd /path/to/your/test-repo
|
|
118
|
-
npm install -D /path/to/project-tiny-context-harness/tmp/sdlc/source-preview/package/project-tiny-context-harness-0.2.
|
|
118
|
+
npm install -D /path/to/project-tiny-context-harness/tmp/sdlc/source-preview/package/project-tiny-context-harness-0.2.40.tgz
|
|
119
119
|
npx --no-install sdlc-harness init --adopt
|
|
120
120
|
make validate-context
|
|
121
121
|
```
|
|
122
122
|
|
|
123
|
-
Use this tarball path only for source-preview testing
|
|
123
|
+
Use this tarball path only for source-preview testing, private review or package development. For normal installs, use `project-tiny-context-harness@latest` from npm.
|
|
124
124
|
|
|
125
125
|
If the source preview path fails, open a [Source preview report](https://github.com/Seven128/project-tiny-context-harness/issues/new?template=source_preview_report.yml) with the command, environment and shortest useful output.
|
|
126
126
|
|
package/assets/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Project Tiny Context Harness
|
|
2
2
|
|
|
3
|
-
[](https://www.npmjs.com/package/project-tiny-context-harness)
|
|
4
4
|
[](https://github.com/Seven128/project-tiny-context-harness/actions/workflows/package.yml)
|
|
5
5
|
[](https://securityscorecards.dev/viewer/?uri=github.com/Seven128/project-tiny-context-harness)
|
|
6
6
|
[](LICENSE)
|
|
@@ -8,8 +8,6 @@
|
|
|
8
8
|
|
|
9
9
|
Translations: [Chinese (Simplified)](README.zh-CN.md)
|
|
10
10
|
|
|
11
|
-
> Rename publish status: GitHub is already renamed, but npm `project-tiny-context-harness` is still pending registry publication. The install commands below are the post-publish path; until `npm run launch:strict-external` no longer reports `npm-fetch`, use the Codespaces or source-preview path in this README. Maintainers can follow [the npm publish runbook](docs/launch/npm-publish-runbook.md).
|
|
12
|
-
|
|
13
11
|
Project Tiny Context Harness is repo-native project memory for AI coding agents.
|
|
14
12
|
|
|
15
13
|
`project-tiny-context-harness` ships Project Tiny Context Harness through the `sdlc-harness` CLI. It installs **Minimal Context Harness**: a compact `project_context/**` fact source, a short `AGENTS.md` startup router, role Skills and a `validate-context` gate so fresh agents can recover project intent, boundaries, verification entry points and next safe actions quickly.
|
|
@@ -51,22 +49,22 @@ flowchart LR
|
|
|
51
49
|
|
|
52
50
|
|
|
53
51
|
|
|
54
|
-
The demo shows the core loop: initialize `AGENTS.md` and `project_context/**`, run `validate-context`, then ask a fresh agent to recover intent before proposing code.
|
|
55
|
-
|
|
56
|
-
No-install preview:
|
|
57
|
-
|
|
58
|
-
- Read the [fresh-agent recovery walkthrough](docs/examples/fresh-agent-recovery.md).
|
|
59
|
-
- Inspect the [Minimal Context sample guide](docs/examples/minimal-context-sample.md).
|
|
60
|
-
- Browse a tiny generated sample repository at [examples/minimal-context-sample/](examples/minimal-context-sample/).
|
|
52
|
+
The demo shows the core loop: initialize `AGENTS.md` and `project_context/**`, run `validate-context`, then ask a fresh agent to recover intent before proposing code. Use the npm install path below, or inspect the no-install previews first.
|
|
61
53
|
|
|
62
|
-
|
|
54
|
+
Install:
|
|
63
55
|
|
|
64
56
|
```sh
|
|
65
57
|
npm install -D project-tiny-context-harness@latest
|
|
66
58
|
npx --yes --package project-tiny-context-harness@latest sdlc-harness init
|
|
67
59
|
```
|
|
68
60
|
|
|
69
|
-
|
|
61
|
+
No-install preview:
|
|
62
|
+
|
|
63
|
+
- Read the [fresh-agent recovery walkthrough](docs/examples/fresh-agent-recovery.md).
|
|
64
|
+
- Inspect the [Minimal Context sample guide](docs/examples/minimal-context-sample.md).
|
|
65
|
+
- Browse a tiny generated sample repository at [examples/minimal-context-sample/](examples/minimal-context-sample/).
|
|
66
|
+
|
|
67
|
+
Source checkout preview:
|
|
70
68
|
|
|
71
69
|
Browser preview:
|
|
72
70
|
|
|
@@ -91,20 +89,16 @@ npm run smoke:quickstart
|
|
|
91
89
|
npm run preview:pack
|
|
92
90
|
```
|
|
93
91
|
|
|
94
|
-
That smoke packs the local workspace, installs it into a disposable repo, runs `sdlc-harness init` and validates the generated Minimal Context files.
|
|
95
|
-
|
|
96
|
-
To try the unpublished package in a separate test repository:
|
|
92
|
+
That smoke packs the local workspace, installs it into a disposable repo, runs `sdlc-harness init` and validates the generated Minimal Context files. Use this path for package development, source-preview testing or private review.
|
|
97
93
|
|
|
98
94
|
```sh
|
|
99
95
|
npm run preview:pack
|
|
100
96
|
cd /path/to/your/test-repo
|
|
101
|
-
npm install -D /path/to/project-tiny-context-harness/tmp/sdlc/source-preview/package/project-tiny-context-harness-0.2.
|
|
97
|
+
npm install -D /path/to/project-tiny-context-harness/tmp/sdlc/source-preview/package/project-tiny-context-harness-0.2.40.tgz
|
|
102
98
|
npx --no-install sdlc-harness init --adopt
|
|
103
99
|
make validate-context
|
|
104
100
|
```
|
|
105
101
|
|
|
106
|
-
Use this tarball path only for source-preview testing while npm publication is pending.
|
|
107
|
-
|
|
108
102
|
If the source preview path fails, open a [Source preview report](https://github.com/Seven128/project-tiny-context-harness/issues/new?template=source_preview_report.yml) with the command, environment and shortest useful output.
|
|
109
103
|
|
|
110
104
|
Use it when coding agents repeatedly lose project intent across new chats, handoffs, RFC/debug turns or tool changes. The intended tradeoff is: keep durable intent and recovery paths; leave execution evidence to code, tests and review.
|