getadvantage 0.1.0 → 0.2.0

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 CHANGED
@@ -24,6 +24,7 @@ No install needed:
24
24
  ```bash
25
25
  npx getadvantage # run the pre-deploy checks (GO / NO-GO)
26
26
  npx getadvantage brief # generate / refresh the project brain
27
+ npx getadvantage init # auto-load the brain at every session start
27
28
  npx getadvantage handoff # save your place for the next session
28
29
  ```
29
30
 
@@ -48,6 +49,9 @@ whichever reads better to you.
48
49
  | `ship-safe` (default `check`) | Read-only pre-deploy checks → exit `0` on **GO**, `1` on **NO-GO**. Add `--build` for a full build. |
49
50
  | `ship-safe brief` | Generate / refresh `PROJECT-BRIEF.md` — the **COLD** layer (what the project *is*). `--check` warns if it's stale; it never blocks. |
50
51
  | `ship-safe handoff` | Refresh the brief **and** write `HANDOFF.md` — the **HOT** layer (where you *left off*). Your notes are preserved across refreshes; it never overwrites a `HANDOFF.md` it didn't create. |
52
+ | `ship-safe init` | Wire the brain into your agent's instructions file (`CLAUDE.md` / `AGENTS.md` / `.cursorrules`) so `PROJECT-BRIEF.md` + `HANDOFF.md` load automatically at session start. |
53
+ | `ship-safe gauge` | A quick "is this session getting heavy?" read (repo activity since your last handoff) that nudges a reset before things slow down — a heuristic, not a token count. |
54
+ | `ship-safe ledger` | Show the session ledger — the running log of save-points each `handoff` records. |
51
55
  | `ship-safe deploy` | _(Advanced)_ Deploy from a clean, detached worktree and confirm the deployment URL's project prefix. Runs a real `vercel --prod`; the project prefix is derived from your linked `.vercel` (or pass `--expect-prefix`). |
52
56
 
53
57
  ## What it is — and isn't