diff --git a/AGENTS.md b/AGENTS.md index 652db41c..b70ebc7d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -29,82 +29,6 @@ Usage notes: - -# Trail - -Record your work as a trajectory for future agents and humans to follow. - -## When Starting Work - -Start a trajectory when beginning a task: - -```bash -trail start "Implement user authentication" -``` - -With external task reference: -```bash -trail start "Fix login bug" --task "ENG-123" -``` - -## Recording Decisions - -Record key decisions as you work: - -```bash -trail decision "Chose JWT over sessions" \ - --reasoning "Stateless scaling requirements" -``` - -For minor decisions, reasoning is optional: -```bash -trail decision "Used existing auth middleware" -``` - -**Record decisions when you:** -- Choose between alternatives -- Make architectural trade-offs -- Decide on an approach after investigation - -## Completing Work - -When done, complete with a retrospective: - -```bash -trail complete --summary "Added JWT auth with refresh tokens" --confidence 0.85 -``` - -**Confidence levels:** -- 0.9+ : High confidence, well-tested -- 0.7-0.9 : Good confidence, standard implementation -- 0.5-0.7 : Some uncertainty, edge cases possible -- <0.5 : Significant uncertainty, needs review - -## Abandoning Work - -If you need to stop without completing: - -```bash -trail abandon --reason "Blocked by missing API credentials" -``` - -## Checking Status - -View current trajectory: -```bash -trail status -``` - -## Why Trail? - -Your trajectory helps others understand: -- **What** you built (commits show this) -- **Why** you built it this way (trajectory shows this) -- **What alternatives** you considered -- **What challenges** you faced - -Future agents can query past trajectories to learn from your decisions. - @@ -553,3 +477,92 @@ git push origin main # NO! ``` This ensures the user maintains control over what goes into the main branch. + + +# Trail + +Record your work as a trajectory for future agents and humans to follow. + +## Usage + +If `trail` is installed globally, run commands directly: +```bash +trail start "Task description" +``` + +If not globally installed, use npx to run from local installation: +```bash +npx trail start "Task description" +``` + +## When Starting Work + +Start a trajectory when beginning a task: + +```bash +trail start "Implement user authentication" +``` + +With external task reference: +```bash +trail start "Fix login bug" --task "ENG-123" +``` + +## Recording Decisions + +Record key decisions as you work: + +```bash +trail decision "Chose JWT over sessions" \ + --reasoning "Stateless scaling requirements" +``` + +For minor decisions, reasoning is optional: +```bash +trail decision "Used existing auth middleware" +``` + +**Record decisions when you:** +- Choose between alternatives +- Make architectural trade-offs +- Decide on an approach after investigation + +## Completing Work + +When done, complete with a retrospective: + +```bash +trail complete --summary "Added JWT auth with refresh tokens" --confidence 0.85 +``` + +**Confidence levels:** +- 0.9+ : High confidence, well-tested +- 0.7-0.9 : Good confidence, standard implementation +- 0.5-0.7 : Some uncertainty, edge cases possible +- <0.5 : Significant uncertainty, needs review + +## Abandoning Work + +If you need to stop without completing: + +```bash +trail abandon --reason "Blocked by missing API credentials" +``` + +## Checking Status + +View current trajectory: +```bash +trail status +``` + +## Why Trail? + +Your trajectory helps others understand: +- **What** you built (commits show this) +- **Why** you built it this way (trajectory shows this) +- **What alternatives** you considered +- **What challenges** you faced + +Future agents can query past trajectories to learn from your decisions. + diff --git a/prpm.lock b/prpm.lock index 1f20e9c8..be169f15 100644 --- a/prpm.lock +++ b/prpm.lock @@ -169,7 +169,24 @@ "sourceFormat": "claude", "sourceSubtype": "skill", "installedPath": ".claude/skills/browser-testing-with-screenshots/SKILL.md" + }, + "@agent-workforce/trail-snippet#agents.md:AGENTS.md": { + "version": "1.0.1", + "resolved": "https://registry.prpm.dev/api/v1/packages/%40agent-workforce%2Ftrail-snippet/1.0.1.tar.gz", + "integrity": "sha256-a7b8d388e19158b1dd4644f2786291e7c90e4b56411c41d4ede1a7d45e7568c9", + "format": "agents.md", + "subtype": "snippet", + "sourceFormat": "generic", + "sourceSubtype": "snippet", + "installedPath": "AGENTS.md", + "snippetMetadata": { + "targetPath": "AGENTS.md", + "config": { + "target": "AGENTS.md", + "position": "append" + } + } } }, - "generated": "2026-01-03T15:28:59.485Z" + "generated": "2026-01-08T20:50:49.376Z" } \ No newline at end of file