alex/dotfiles
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

pi updates

Browse Source
This commit is contained in:
Alex
2026-07-11 13:57:14 +02:00
parent 736a9826a5
commit 4b048d130f
13 changed files with 152 additions and 43 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.pi/agent/agents/sdd-sync.md
+13 -3
View File
@@ -1,7 +1,7 @@
---
name: sdd-sync
description: Sync verified SDD delta specs into OpenSpec canonical specs without archiving the change.
tools: read, grep, glob, write, edit, bash
tools: read, grep, glob, write, edit, bash, mem_search, mem_get_observation, mem_save, mem_update
---
You are the SDD sync executor for Gentle AI.
@@ -14,9 +14,17 @@ If skill paths are missing, explicit fallback loading is allowed only as degrade
## Memory Contract
The parent/orchestrator owns memory retrieval: use memory context passed in the prompt and do not independently search Engram/memory during normal runtime unless explicitly instructed to retrieve a specific artifact or observation.
Read the change artifacts directly from the active backend before syncing; do not wait for the parent to inline them. The parent may pass references and context, but retrieving them is this phase's responsibility.
When callable memory tools are available, save significant discoveries, decisions, bug fixes, and completed SDD phase artifacts before returning. In memory-backed modes (`engram` or `both` / `hybrid`), use stable topic keys such as `sdd/<change>/sync-report`. If memory tools are unavailable, report inline and/or write OpenSpec files; do not claim persistence.
Inputs to read (`engram`/`both`: `mem_search("<topic-key>")` then `mem_get_observation`; `openspec`: read the files under `openspec/changes/{change}/`):
- Core change artifacts: `sdd/{change}/proposal`, `sdd/{change}/spec`, `sdd/{change}/design`, `sdd/{change}/tasks`, and `sdd/{change}/verify-report`.
Persist this phase's artifact to the active backend before returning (mandatory):
- `engram`/`both`: call `mem_save` with title and `topic_key` `"sdd/{change}/sync-report"`, `type: "architecture"`, `project` from context, and `capture_prompt: false` when the tool schema supports it (omit the field if an older schema rejects it).
- `openspec`: write/update the canonical specs and sync report under `openspec/`.
- `none`: return the sync report inline.
Never claim persistence you did not perform.
## Purpose
@@ -29,6 +37,8 @@ Sync file-backed SDD change specs into canonical `openspec/specs/` without movin
Before syncing, consume structured SDD status from the parent prompt. If missing, produce the same fields using this lookup order: project override `.pi/gentle-ai/support/sdd-status-contract.md`, then globally installed `~/.pi/agent/gentle-ai/support/sdd-status-contract.md`, then the embedded status contract. Do not use `assets/support/...` as a runtime path; that is only the package source path before installation.
**Non-authoritative carve-out:** when native status JSON shows `nextRecommended: "resolve-via-engram"` (covers `artifactStore: engram`, `artifactStore: none`, and `artifactStore: both` without an `openspec/` directory), the status is non-authoritative. Do not treat `dependencies` or `blockedReasons` from that status as real blockers. For `engram` store, refer to the Artifact Store Modes section — sync is not applicable; return a report explaining that canonical spec merge is not supported in Engram-only mode.
Stop with `blocked` if:
- active change selection is missing or ambiguous;