Add PA knowledge base design and handoff docs

- Design doc: two-KB architecture (shared + PA-private)
- Lazy-load with session caching
- Minified JSON format for all state files
- Hybrid learning (explicit + implicit with confirmation)
- Handoff doc for next session implementation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
OpenCode Test
2025-12-28 22:21:15 -08:00
parent fa049a1374
commit f006046d14
3 changed files with 376 additions and 0 deletions

View File

@@ -0,0 +1,138 @@
{
"version": "1.0.0",
"description": "Deferred features and decisions for future implementation",
"items": [
{
"id": "fc-001",
"category": "infrastructure",
"title": "Workstation monitoring with Prometheus",
"description": "Deploy node_exporter and Alertmanager for workstation metrics and alerting",
"priority": "medium",
"status": "deferred",
"created": "2024-12-28",
"notes": "Would enable proactive alerting for disk, memory, CPU issues"
},
{
"id": "fc-002",
"category": "agent",
"title": "Network admin agent",
"description": "Agent for network configuration, firewall rules, VPN management",
"priority": "medium",
"status": "deferred",
"created": "2024-12-28",
"notes": "Would manage iptables/nftables, NetworkManager, WireGuard"
},
{
"id": "fc-003",
"category": "agent",
"title": "Personal assistant agent",
"description": "Agent for personal tasks, reminders, scheduling",
"priority": "medium",
"status": "deferred",
"created": "2024-12-28",
"notes": "Integration with calendar, task management"
},
{
"id": "fc-004",
"category": "integration",
"title": "External LLM integration",
"description": "Support for non-Claude models in the agent system",
"priority": "low",
"status": "deferred",
"created": "2024-12-28",
"notes": "For specialized tasks or cost optimization"
},
{
"id": "fc-005",
"category": "optimization",
"title": "Model usage logging and cost tracking",
"description": "Track model usage across agents for cost analysis",
"priority": "medium",
"status": "deferred",
"created": "2024-12-28",
"notes": "Would help optimize model selection policy"
},
{
"id": "fc-006",
"category": "design",
"title": "Slash commands redesign",
"description": "Revisit slash command architecture and user experience",
"priority": "low",
"status": "deferred",
"created": "2024-12-28",
"notes": "Current design may need refinement"
},
{
"id": "fc-007",
"category": "optimization",
"title": "Document structure optimization",
"description": "Optimize agent document format for efficiency",
"priority": "low",
"status": "deferred",
"created": "2024-12-28",
"notes": "Balance between clarity and token usage"
},
{
"id": "fc-008",
"category": "infrastructure",
"title": "ArgoCD CLI authentication",
"description": "Configure argocd CLI with proper authentication",
"priority": "medium",
"status": "resolved",
"created": "2025-12-28",
"resolved": "2025-12-28",
"notes": "Using 10-year API token (expires 2035-12-26). Token ID: e3980c6a-1c4e-4f1a-8459-a120a5c60cc5. Stored in ~/.config/argocd/config. No renewal automation needed."
},
{
"id": "fc-009",
"category": "infrastructure",
"title": "Prometheus local port-forward",
"description": "Document Prometheus access patterns for agents",
"priority": "low",
"status": "identified",
"created": "2025-12-28",
"notes": "Prometheus not accessible on localhost:9090. Options: (1) use kubectl exec to query, (2) set up port-forward, (3) use ingress. Currently works via pod exec."
},
{
"id": "fc-010",
"category": "infrastructure",
"title": "Clone homelab gitops repo locally",
"description": "Clone git@github.com:will666/homelab.git for git-operator access",
"priority": "low",
"status": "resolved",
"created": "2025-12-28",
"resolved": "2025-12-28",
"notes": "Cloned to ~/.claude/repos/homelab"
},
{
"id": "fc-011",
"category": "k8s-health",
"title": "Address OutOfSync ArgoCD apps",
"description": "5 apps OutOfSync, 1 Degraded (porthole)",
"priority": "medium",
"status": "identified",
"created": "2025-12-28",
"notes": "OutOfSync: adopt-a-street, ai-stack, gitea, home-assistant, kubernetes-dashboard, speetest-tracker. Degraded: porthole"
},
{
"id": "fc-012",
"category": "agent-memory",
"title": "PA knowledge base with session caching",
"description": "Local KB for infrastructure facts with lazy-load and in-session caching",
"priority": "medium",
"status": "designed",
"created": "2025-12-28",
"notes": "Design complete. See docs/plans/2025-12-28-pa-knowledge-base-design.md. Handoff ready for implementation."
},
{
"id": "fc-013",
"category": "agent-memory",
"title": "Vector database for agent long-term memory",
"description": "Semantic search over agent knowledge using embeddings",
"priority": "low",
"status": "deferred",
"created": "2025-12-28",
"notes": "Would enable fuzzy matching, semantic queries, and scalable knowledge storage. Consider: ChromaDB, Qdrant, or pgvector."
}
]
}