feat: Add PlatformAgent with TAP + TOML configuration

[r-pedraza]

Summary

Adds PlatformAgent - a platform engineering agent using TAP (Titan Adapter Protocol) with TOML-based configuration.

This agent provides AI-driven autonomous task execution for Git workflows with framework-agnostic tool calling.

Key Features

🤖 PlatformAgent

• TOML Configuration: Consistent with project standards (no new dependencies)
• TAP Integration: Uses TAP protocol for framework-agnostic tool calling
• AI Autonomy: AI decides which tools to use based on task context
• Git Tools: get_git_status, analyze_git_diff, create_commit
• CLI Command: titan agent platform

🛠️ Available Tools

1. get_git_status - Check repository status (modified files, branch)
2. analyze_git_diff - Understand what changed in the code
3. create_commit - Create conventional commits

📋 Usage

# Interactive mode
titan agent platform

# Auto-confirm mode
titan agent platform --yes

# Custom repository path
titan agent platform -p /path/to/repo

# Custom config file
titan agent platform -c custom_agent.toml

📁 Files Added

• config/agents/platform_agent.toml - Agent configuration
• titan_cli/agents/platform_agent.py - PlatformAgent implementation
• titan_cli/agents/__init__.py - Module exports
• titan_cli/commands/agent.py - CLI command
• docs/PLATFORM_AGENT.md - Documentation

🎯 Example Workflow

1. User runs: titan agent platform
2. AI analyzes Git status
3. AI reads git diff to understand changes
4. AI creates conventional commit with appropriate message
5. User confirms (or auto-confirms with --yes)

🔧 Configuration Example

[agent]
name = "platform_agent"
description = "Platform engineering agent for Git, GitHub, and development workflows"

[tap]
provider = "anthropic"

[[tap.tools]]
name = "get_git_status"
enabled = true

[[tap.tools]]
name = "create_commit"
enabled = true

🧪 Testing

Requires TAP implementation from PR #25.

# After PR #25 is merged
poetry install
titan agent platform --help

📊 Architecture

PlatformAgent
├── TOML Config (platform_agent.toml)
├── TAP Protocol (framework-agnostic)
├── Git Tools (TitanTool implementations)
├── AI Provider (Anthropic via TAP)
└── CLI Command (titan agent platform)

🔗 Dependencies

• Requires: PR feat: Implement TAP (Titan Adapter Protocol) for framework-agnostic tool calling #25 (TAP implementation)
• No new dependencies: Uses existing tomli for TOML parsing

✅ Checklist

• TOML configuration implemented
• PlatformAgent class with from_toml loader
• CLI command registered
• Git tools integrated
• Documentation added
• No new dependencies added

Related

• PR feat: Implement TAP (Titan Adapter Protocol) for framework-agnostic tool calling #25: TAP (Titan Adapter Protocol) implementation

🤖 Generated with Claude Code

[r-pedraza]

Test