← Back to Context Comparison

Project-Level Agents

Infrastructure-specific specialist agents for linuxserver.lan

Location: ~/projects/.claude/agents/
5 Agents Infrastructure-Focused Coordinated by PM

What Are Project-Level Agents?

Project-level agents are autonomous specialists stored at ~/projects/.claude/agents/. These agents are specific to the linuxserver.lan infrastructure and handle the actual implementation work: architecture design, code deployment, and security/network configuration. They are typically coordinated by the PM agent for complex multi-step projects, but can also be invoked directly via the Task tool for focused tasks.

Agent Coordination Flow

๐Ÿ“‹ PM
Orchestrates
โ†’
๐Ÿ›๏ธ Architect
Designs
โ†’
๐Ÿ”’ Security
Configures
โ†’
๐Ÿ‘จโ€๐Ÿ’ป Developer
Implements
โ†’
๐Ÿงช QA
Tests

Typical flow: PM breaks down tasks โ†’ Architect designs โ†’ Security configures โ†’ Developer implements โ†’ QA tests

๐Ÿ›๏ธ

Architect Sonnet

architect

System design and architecture specialist for infrastructure design, technology stack decisions, service integration planning, performance optimization, and architecture reviews. Designs robust, scalable systems with expertise in Docker, databases, networking, and microservices.

๐Ÿ› ๏ธ Available Tools

Read Write Grep Glob Bash

๐ŸŽฏ Core Expertise

  • System architecture design and patterns
  • Technology stack evaluation and selection
  • Service integration and API design
  • Performance and scalability analysis
  • Database architecture and data modeling
  • Container orchestration patterns

๐Ÿ“‚ Context Files

  • infrastructure-overview.md
  • service-inventory.md
  • architecture-patterns.md
  • integration-standards.md
  • technology-standards.md

๐Ÿ”— Escalates To

  • Developer - Implementation feedback
  • Security - Network feasibility, security review
  • PM - Trade-off decisions, requirements
๐Ÿ‘จโ€๐Ÿ’ป

Developer Sonnet

developer

Implementation and deployment specialist for coding, service deployment, debugging, database operations, container management, and hands-on technical work. Expert in Python, Docker, PostgreSQL, MongoDB, Redis, and cloud-native deployment.

๐Ÿ› ๏ธ Available Tools

Read Write Edit Grep Glob Bash

๐ŸŽฏ Core Expertise

  • Python development (FastAPI, Flask, Django)
  • Docker and docker-compose deployment
  • Database operations (PostgreSQL, MongoDB, Redis)
  • Container debugging and log analysis
  • CI/CD and deployment automation
  • API development and integration

๐Ÿ“‚ Context Files

  • coding-standards.md
  • deployment-patterns.md
  • logging-standards.md
  • integration-guide.md
  • debugging-procedures.md

๐Ÿ”— Escalates To

  • Architect - Design flaws, architecture gaps
  • Security - Routing, auth, network changes
  • PM - Blockers, scope changes
๐Ÿ”’

Security Sonnet

security

Security and network infrastructure specialist for network topology, firewall rules, SSL/TLS configuration, Keycloak/OAuth2 setup, Traefik routing, and security audits. Expert in Docker networking, reverse proxy configuration, and authentication systems.

๐Ÿ› ๏ธ Available Tools

Read Write Grep Glob Bash

๐ŸŽฏ Core Expertise

  • Network topology and Docker networking
  • Traefik reverse proxy configuration
  • SSL/TLS certificate management
  • Keycloak SSO and OAuth2/OIDC
  • Firewall rules and network security
  • Security hardening and vulnerability assessment

๐Ÿ“‚ Context Files

  • network-topology.md
  • security-policies.md
  • traefik-patterns.md
  • keycloak-integration.md
  • security-checklist.md

๐Ÿ”— Escalates To

  • Architect - Architecture context, dependencies
  • Developer - Implementation, testing
  • PM - Security trade-offs, compliance
๐Ÿงช

QA Sonnet

qa

Quality Assurance specialist for test creation, GitLab CI integration, pipeline monitoring, and quality gate enforcement. Creates comprehensive test suites from developer specifications, commits to GitLab, and reports results with detailed failure analysis.

๐Ÿ› ๏ธ Available Tools

Read Write Edit Grep Glob Bash

๐ŸŽฏ Core Expertise

  • Test design and specification (pytest, jest)
  • GitLab CI pipeline integration
  • Test execution monitoring via API
  • Quality gate enforcement
  • Bug identification and documentation
  • Test automation patterns

๐Ÿ“‚ Context Files

  • developer/specs/{project}/spec.md
  • qa/tests/{project}/
  • qa/results/{project}/results.md
  • qa/reports/{project}/quality-report.md

๐Ÿ”— Escalates To

  • Developer - Spec ambiguity, implementation bugs
  • PM - Quality gate failures, scope changes

Project Agents vs User Agents

Aspect Project-Level Agents User-Level Agents
Location ~/projects/.claude/agents/ ~/.claude/agents/
Scope Infrastructure-specific implementation Universal orchestration
Count 5 agents 1 agent (PM)
Role Execute specialized tasks Coordinates other agents
Agents Architect, Developer, Security, QA PM (Project Manager)
Invocation subagent_type="architect|developer|security|qa" subagent_type="pm"