clenci

clenci/arch-advisor

Plugin Claude Code

Architecture tooling for multi-agent LLM systems.

clenci/arch-advisor

Instructions file

Claude Code instructions for clenci/arch-advisor, covering arch-advisor — development context, what this repository is, structure, how to install the plugin and local development (without installing).

clenci/arch-advisor

Plugin Claude Code

Interactive architecture advisor for multi-agent LLM systems. Guides through structured discovery, tension resolution, requirements stress testing, and architecture proposal. Generates C4 diagram, ADR, decision matrix, and NFR checklist. Supports post-artifact deepening on domain-specific topics.

clenci/arch-advisor

Command

Interactive architecture advisor for multi-agent LLM systems. Guides through discovery, tension resolution, requirements stress testing, and artifact generation.

clenci/arch-advisor

Hook

Runs when a session starts, executing session_start.py via python3. From clenci/arch-advisor.

clenci/arch-advisor

Skill Claude CodeCodex

Use this skill when designing the internal structure of a single agent, when discussing perception layers, decision layers, memory management, reflection loops, state management, or when someone says 'how should the agent be structured internally?', 'how do we handle memory?', 'should state be mutable or immutable?'…

clenci/arch-advisor

Skill Claude CodeCodex

Use this skill when documenting architectural decisions, creating ADRs, drawing C4 diagrams, writing RFCs, or presenting architecture to stakeholders. Trigger when someone says 'we need to document this decision', 'write an ADR', 'create a C4 diagram', 'how do we explain this to management?', 'we need an RFC', 'how do…

clenci/arch-advisor

Skill Claude CodeCodex

Use this skill when choosing storage systems, designing the data layer, deciding between databases, or designing agent memory. Trigger when someone says 'what database should we use?', 'where do we store agent state?', 'how do we persist memory between sessions?', 'we need vector storage for embeddings', 'how do we…

clenci/arch-advisor

Skill Claude CodeCodex

Use this skill when designing how agents expose or consume tools and APIs, when discussing MCP servers, A2A communication, tool registries, or when someone says 'agents need to call external APIs', 'how should agents communicate with each other?', 'we need to expose tools to the LLM', 'designing agent-to-agent…

clenci/arch-advisor

Skill Claude CodeCodex

Use this skill when integrating AI agents with existing enterprise systems, legacy APIs, ERPs, CRMs, or when migrating from legacy to agent-based systems. Trigger when someone says 'we have existing systems the agent must use', 'we need to integrate with our ERP/CRM', 'legacy system has a different data model', 'how…

clenci/arch-advisor

Skill Claude CodeCodex

Use this skill when choosing between LangChain, LangGraph, CrewAI, Semantic Kernel, or custom implementation, when someone asks 'which framework should we use?', 'should we use LangGraph or LangChain?', 'is CrewAI a good fit?', 'should we build custom?', 'we need a framework for our agents', 'comparing LLM…

clenci/arch-advisor

Skill Claude CodeCodex

Use this skill when choosing which LLM to use, comparing providers, designing routing between models, handling LLM fallbacks, or optimizing LLM costs. Trigger when someone says 'which model should we use?', 'we need to choose between GPT-4 and Claude', 'how do we route to cheaper models for simple tasks?', 'we need…

clenci/arch-advisor

Skill Claude CodeCodex

Use this skill when designing systems with multiple agents, when choosing between centralized and decentralized coordination, when discussing pipelines, DAGs, agent communication, event-driven architectures, or when someone says 'we need multiple agents working together', 'how should agents coordinate?', 'should…

clenci/arch-advisor

Skill Claude CodeCodex

Use this skill when discussing monitoring, observability, SLOs, alerting, dashboards, or production reliability for AI systems. Trigger when someone says 'how do we monitor the agent?', 'we need alerts', 'how do we know if quality is degrading?', 'SLO for the system', 'the agent is slow and we don't know why', 'cost…

clenci/arch-advisor

Skill Claude CodeCodex

Use this skill when designing customer-facing systems across multiple channels, when discussing chatbots, omnichannel, WhatsApp integration, web chat, email automation, or when someone says 'we need to serve customers on multiple channels', 'WhatsApp + web + email support', 'agent must adapt to each channel', 'we need…

clenci/arch-advisor

Skill Claude CodeCodex

Use this skill during Phase 3.5 Pattern Deepening to provide implementation-level guidance for the specific patterns present in the chosen architecture. Contains twelve pattern blocks: Hybrid Decision Engine, Planner-Executor-Critic, Voting + Arbiter, Saga with Compensation, Human-in-the-Loop with Checkpointing…

clenci/arch-advisor

Skill Claude CodeCodex

Use this skill when designing RAG (Retrieval-Augmented Generation) pipelines, choosing chunking strategies, retrieval methods, embedding models, or reranking approaches. Trigger when someone says 'we need to search our documents', 'the agent needs to answer questions from our knowledge base', 'how should we chunk and…

clenci/arch-advisor

Skill Claude CodeCodex

Use this skill when discussing security, compliance, risk management, governance, or responsible AI for agent systems. Trigger when someone says 'we need LGPD compliance', 'how do we handle prompt injection?', 'what are the risks of using LLMs?', 'we need an audit trail', 'how do we govern AI models?', 'we process…

clenci/arch-advisor

Skill Claude CodeCodex

Use this skill when designing testing strategies for AI agent systems, setting up quality evaluations, defining quality gates, or when someone says 'how do we test agents?', 'we need evals for LLM output', 'how to test non-deterministic systems?', 'quality gate for deployment', 'LLM-as-judge', 'regression testing for…

clenci/arch-advisor

Skill Claude CodeCodex

Use this skill when someone asks whether to build an agent or a traditional service, when to apply AI vs. deterministic logic, whether a use case justifies LLMs, or when a user says things like 'should we use AI here?', 'is this a good case for an agent?', 'we're deciding between an LLM and a rule-based system', 'does…