go-agentic

AI service lifecycle, task management, and fleet orchestration knowledge base.

Package Overview

go-agentic implements the Core DI service pattern for AI-assisted CLI operations. It manages allowance/quota tracking, context building for AI prompts, completion requests, and claude CLI subprocess spawning.

Module: forge.lthn.ai/core/go-agentic Size: ~2,000 LOC (14 files, 5 test files)

Key Features

Service lifecycle: Integrates with Core framework DI (OnStartup, ServiceRuntime)
Allowance management: Per-workspace quota tracking and enforcement
Context building: Assembles project context for AI prompts
Completion client: HTTP client for AI provider APIs
CLI integration: Spawns claude subprocess for commits and prompts

Dependencies

Module	Purpose
`core/go`	Framework (ServiceRuntime, io, log)
`gopkg.in/yaml.v3`	Configuration parsing

Package Docs

Service-Lifecycle — Core DI integration and startup
Allowance — Quota tracking and enforcement

Fleet Operations

This wiki also serves as the shared knowledge base for the agent fleet — how we run multiple domain-expert AI agents across the Core Go ecosystem.

Fleet-Delegation-Pattern — The CLAUDE.md/TODO.md/FINDINGS.md contract, roles, onboarding
Platform-Matrix — Which packages run where (macOS vs Linux) and why
Inference-Architecture — How go-inference, go-mlx, go-rocm, go-ml fit together
Contributing-From-Linux — Guide for Charon and Linux agents (ROCm, llama.cpp, assigned packages)
Clotho-Agent — Clotho AU: autonomous agent on darbs (PHP/Go work via forge.lthn.ai)