go-agentic/CLAUDE.md
Snider 6e8ae2a1ec docs: graduate TODO/FINDINGS into production documentation
Replace internal task tracking (TODO.md, FINDINGS.md) with structured
documentation in docs/. Trim CLAUDE.md to agent instructions only.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-02-20 15:02:20 +00:00

1.1 KiB

CLAUDE.md

Project Overview

AI service lifecycle and task management library. Module: forge.lthn.ai/core/go-agentic

Implements the Core framework service pattern for AI-assisted CLI operations: allowance/quota management, agent registry, task routing and dispatch, context building, completion requests, and claude CLI subprocess spawning.

See docs/architecture.md for component details.

Build Commands

go test ./...                    # Run all tests
go test -v -run TestName ./...   # Single test
go test -race ./...              # With race detector
go test -bench=. ./...           # Benchmarks

Coding Standards

  • UK English (colour, organisation, behaviour, licence, serialise)
  • Exported types and functions require Go doc comments
  • Error strings use log.E(op, "message", err) from the Core framework
  • Defensive copies on all in-memory store Get/Set operations
  • Tests: github.com/stretchr/testify/assert and require
  • Conventional commits: type(scope): description
  • Co-Author: Co-Authored-By: Virgil <virgil@lethean.io>
  • Licence: EUPL-1.2