lindoelio/paperclip-spec-driven/psd-stewardship

Contextual Stewardship & Company-Brain Bridge

The psd-stewardship skill acts as an organizational memory steward across autonomous agent heartbeats. It prevents agents from repeating past mistakes and ensures company-wide architectural decisions remain durable.

Core Capabilities

1. Shared Memory Bridge: Synchronizes markdown records in facts/, decisions/, and lessons/ within the company-brain repository. When running in standalone mode, it maintains a local JSON knowledge graph at .psd/knowledge-graph.json.
2. Heartbeat Context Injection: Retrieves relevant historical decisions using weighted scoring:

• 50% Keyword Match (token overlap with current prompt/spec)
• 30% Recency (exponential decay over 30 days)
• 20% Confidence (explicit confidence weight)

1. Architectural Contradiction Detection (REQ-6.4): Automatically detects when a proposed decision contradicts existing recorded rules on the same domain topic and flags the conflict for resolution by the architecture role.

Command Reference

1. Retrieve & Inject Context on Heartbeat

Inject relevant guidelines and decisions into the active agent context before planning or implementing:

psd stewardship inject "How should database migrations and ORM entities be handled?"

Add --json for programmatic integration into agent prompts.

2. Store Durable Decisions & Lessons

Record a confirmed technical decision or operational lesson:

# Record an architectural decision
psd stewardship store "Use Go Static Binaries Without CGO" \
  --category decision \
  --content "All CLI commands must compile with CGO_ENABLED=0 for portable static binaries." \
  --tags "golang,build,static,cgo" \
  --confidence 1.0
 
# Record an operational lesson
psd stewardship store "Always run migrations before starting API server" \
  --category lesson \
  --content "Running the server before migrations caused connection pool timeouts during startup." \
  --tags "database,deployment,migrations"

3. List Active Knowledge Records

psd stewardship list