Connectry Architect Cert

Aprueba el examen de Certified Architect de Claude

Preparación adaptativa para la certificación impulsada por el Model Context Protocol.
390 preguntas. Proyecto final guiado. 30 guías de conceptos. 6 proyectos de referencia. Exámenes de práctica. Panel interactivo. Repetición espaciada. Cero adulación.

Inicio rápido • Ruta de aprendizaje • Experiencia interactiva • Evaluación • Guías • Práctica • Proyecto final • Exámenes de práctica • Panel • Proyectos de referencia • Herramientas • Arquitectura

¿Qué es Architect Cert?

Architect Cert es un servidor MCP gratuito y de código abierto que convierte a Claude en tu tutor personal de certificación para el examen Claude Certified Architect — Foundations. Sin cursos, sin diapositivas, sin videoconferencias — solo pregúntale a Claude y estudia.

Incluye:

• 390 preguntas basadas en escenarios en los 5 dominios del examen y 30 declaraciones de tareas
• Interfaz interactiva clicable — responde preguntas con botones A/B/C/D, selecciona seguimientos, elige dominios con casillas de verificación — todo dentro de Claude
• Evaluación primero con lecciones — aprende los conceptos de cada dominio antes de ser evaluado
• Proyecto final guiado — da forma a tu propio proyecto, luego constrúyelo paso a paso mientras aprendes cada declaración de tarea en la práctica
• 30 guías de conceptos — una por declaración de tarea, con ejemplos de código y errores comunes
• 6 proyectos de referencia — bases de código TypeScript ejecutables que demuestran cada dominio en la práctica
• Exámenes de práctica — exámenes ponderados de 60 preguntas con seguimiento de historial y tendencias de mejora
• Panel de progreso — panel visual con efecto glassmorphism con niveles de dominio, gráfico de historial de exámenes, línea de tiempo de actividad
• Seguimiento visual del progreso — listas de verificación de tareas que rastrean tu progreso a través de evaluaciones, exámenes y proyectos finales en tiempo real
• Seguimientos interactivos — ¿Respuesta incorrecta? Haz clic para ver ejemplos de código, lecciones de conceptos, guías o proyectos de referencia
• Generación de PDF — guías PDF con marca y logotipo de Architect Cert para estudio sin conexión
• Repetición espaciada — el algoritmo SM-2 programa revisiones en intervalos óptimos
• Calificación determinista — calificación con funciones puras, sin juicio de LLM, cero adulación

Todo se ejecuta localmente. Sin nube, sin cuentas, sin telemetría.

Inicio rápido

1. Instalación

npm install -g connectry-architect-mcp

2. Configura tu cliente MCP

claude mcp add connectry-architect -- connectry-architect-mcp

{
  "mcpServers": {
    "connectry-architect": {
      "command": "connectry-architect-mcp"
    }
  }
}

{
  "mcpServers": {
    "connectry-architect": {
      "command": "connectry-architect-mcp"
    }
  }
}

{
  "mcpServers": {
    "connectry-architect": {
      "command": "connectry-architect-mcp"
    }
  }
}

3. Comienza a estudiar

Reinicia tu cliente MCP y comienza a chatear:

Ruta de aprendizaje

Architect Cert está diseñado para seguir una progresión natural. Aquí está el orden recomendado:

1. Assessment        → Baseline your knowledge across all 5 domains
       ↓
2. Learn concepts    → Read handouts for weak domains before practicing
       ↓
3. Adaptive practice → Questions prioritized by weakness, reviews, new material
       ↓
4. Follow-ups        → Dive into code examples, concept lessons, reference projects
       ↓
5. Capstone build    → Build your own project covering all 30 task statements
       ↓
6. Practice exams    → Simulate the real exam (60 questions, scored out of 1000)
       ↓
7. Review & repeat   → Dashboard tracks mastery, spaced repetition handles scheduling

Puedes saltar a cualquier etapa en cualquier momento — el sistema se adapta. Pero la ruta anterior te brinda la experiencia más estructurada.

Experiencia interactiva

Architect Cert utiliza la interfaz interactiva integrada de Claude para que estudiar se sienta natural. Sin escribir letras de respuesta — solo haz clic.

Selección de respuesta clicable

Cada pregunta presenta botones A/B/C/D clicables directamente en Claude. Toca tu respuesta en lugar de escribirla. Si la pregunta incluye código en el escenario, aparece una vista previa de código junto a cada opción para que puedas consultarla mientras decides.

Acciones de seguimiento

Después de cada respuesta, aparecen botones de seguimiento clicables:

Después de una respuesta incorrecta:

• Entendido, siguiente pregunta
• Explica con un ejemplo de código
• Muéstrame la lección de concepto
• Muéstrame la guía
• Muéstramelo en el proyecto de referencia

Después de una respuesta correcta:

• Siguiente pregunta
• Explica por qué las otras son incorrectas

Selector de dominio de selección múltiple

Al solicitar un plan de estudio, puedes seleccionar múltiples dominios para enfocarte usando casillas de verificación — sin necesidad de enumerarlos por nombre.

Listas de verificación de progreso visual

Los flujos largos como la evaluación (15 preguntas), los exámenes de práctica (60 preguntas) y el proyecto final (18 pasos) crean una lista de verificación de tareas visual que se actualiza en tiempo real a medida que avanzas. Siempre sabes dónde estás y qué queda.

Omitir y Otro

Cada selección de pregunta incluye un botón Omitir para avanzar y una opción Otro para hacer una pregunta de formato libre. Si usas "Otro" para preguntar algo, Claude responde tu pregunta y luego vuelve a presentar la misma pregunta del cuestionario — nunca pierdes tu lugar. "Omitir" avanza a la siguiente pregunta; las preguntas omitidas permanecen sin responder y reaparecerán más tarde.

Evaluación inicial

Comienza con un diagnóstico de 15 preguntas (3 por dominio) que determina tu ruta de aprendizaje. La evaluación funciona de manera diferente a la práctica directa:

Flujo primero con lecciones

Cuando la evaluación llega a un nuevo dominio por primera vez, se pausa para mostrarte la guía de conceptos antes de hacer preguntas. Esto significa que aprendes las ideas clave, ves ejemplos de código y entiendes errores comunes antes de ser evaluado — sin adivinar a ciegas.

El flujo para cada dominio:

1. Se muestra la guía de conceptos (una vez por dominio)
2. Se presentan 3 preguntas una a la vez (fácil, media, difícil)
3. Cada respuesta se califica inmediatamente con explicación
4. Avanza al siguiente dominio

Asignación de ruta

Según tu precisión general:

Seguimiento del progreso

La evaluación crea una lista de verificación visual de 15 elementos (P1 a P15, agrupados por dominio) que se actualiza después de cada respuesta. Siempre ves exactamente cuánto has avanzado.

Guías de conceptos

Cada declaración de tarea tiene una guía de conceptos — un documento de estudio estructurado (~500-800 palabras) que cubre:

• Concepto — La idea central, el modelo mental y cuándo/por qué usarlo
• Ejemplo de código — TypeScript realista que demuestra el patrón
• Errores comunes — Los 3-5 errores más frecuentes (que se corresponden con respuestas incorrectas del examen)
• Referencias — Enlaces a la documentación oficial de Anthropic

Lectura de guías en Claude

You: "Show me the handout for task 2.3"

Claude: [loads the full handout with concept, code, mistakes, references]

Cuándo aparecen las guías automáticamente

• Durante la evaluación — se muestran antes de la primera pregunta de cada nuevo dominio
• Después de una respuesta incorrecta — "Muéstrame la guía" es una de las opciones de seguimiento
• Durante el proyecto final — las guías relevantes están disponibles en cada paso de construcción

Generación de guías PDF

Genera PDF con marca para las 30 guías para estudio sin conexión:

cd connectrylab-architect-cert-mcp
npm run generate:pdfs

Esto crea 30 PDF en generated/handouts/ con:

• Logotipo de Architect Cert y etiqueta de dominio en el encabezado
• Formato limpio con bloques de código resaltados con sintaxis
• Pie de página "Connectry LABS — Claude Certified Architect Exam Prep — Free & Open Source"

Práctica adaptativa

Cada pregunta de práctica se selecciona mediante un algoritmo de tres prioridades:

1. Revisiones vencidas — Elementos de repetición espaciada que deben revisarse hoy
2. Áreas débiles — Temas donde tu dominio está por debajo del 50%
3. Material nuevo — Preguntas nuevas de tu dominio recomendado

Filtrado

Puedes filtrar preguntas de práctica por dominio y/o dificultad:

You: "Give me a hard question about prompt engineering"

Claude: [presents a hard Domain 4 question with clickable A/B/C/D buttons]

Seguimientos interactivos

Después de cada respuesta, obtienes opciones de seguimiento clicables. Cada opción profundiza en el concepto — y luego te devuelve directamente a tu cuestionario. Nunca abandonas tu flujo de estudio para buscar algo.

Niveles de dominio

Cada una de las 30 declaraciones de tarea tiene un nivel de dominio independiente:

Repetición espaciada (SM-2)

El algoritmo SM-2 programa intervalos de revisión:

• Primera revisión: 1 día después de responder
• Segunda revisión: 3 días después de la primera revisión
• Revisiones posteriores: Intervalo anterior x factor de facilidad (comienza en 2.5)
• Respuesta incorrecta: El intervalo se reinicia, el factor de facilidad disminuye en 0.2 (mínimo: 1.3)
• Respuesta correcta: El factor de facilidad aumenta en 0.1

Las preguntas difíciles vuelven con frecuencia. Las fáciles se espacian a semanas o meses.

Proyecto final guiado

La forma más práctica de aprender: construye tu propio proyecto desde cero mientras cubres las 30 declaraciones de tareas. En lugar de solo responder preguntas, diseñas un sistema real basado en tu propia idea.

Cómo Funciona

La construcción del proyecto final tiene tres fases:

Fase 1 — Definición del Proyecto

Describes una idea de proyecto (por ejemplo, "un sistema de revisión de código multiagente"). Claude analiza tu idea contra los 30 criterios arquitectónicos e identifica las brechas. Refinas juntos hasta que cada declaración de tarea esté cubierta.

You: "I want to start a guided capstone build"

Claude: [presents the 30 criteria across all 5 domains]
        Describe your project idea and I'll analyze coverage.

You: "A multi-agent code review system that analyzes PRs"

Claude: Your idea naturally covers 24/30 criteria. To cover the
        remaining 6, I'd suggest adding: [specific suggestions
        mapped to task statements]

Fase 2 — Construcción Intercalada (18 pasos)

Cada paso sigue el mismo patrón:

1. Cuestionario — 2-3 preguntas sobre las declaraciones de tareas que estás por construir (botones clicables A/B/C/D)
2. Construcción — Claude genera el código del archivo, temático para tu proyecto
3. Recorrido — Explicación línea por línea que mapea el código a las declaraciones de tareas

Una lista de verificación visual de 18 pasos rastrea tu progreso en tiempo real.

Los 18 pasos se construyen incrementalmente:

Cada respuesta del cuestionario alimenta la misma repetición espaciada y el seguimiento de dominio que la práctica regular.

Fase 3 — Revisión Final

Después del paso 18, obtienes un mapa de cobertura completo: las 30 declaraciones de tareas, dónde se demuestra cada una en tu proyecto, y tu rendimiento en el cuestionario por dominio. Las áreas débiles se marcan para estudio adicional.

Herramientas de Construcción del Proyecto Final

Cómo se Conecta con Todo lo Demás

• Las respuestas del cuestionario durante la construcción usan la misma calificación submit_answer y la programación SM-2
• Después de cualquier pregunta del cuestionario, puedes usar las mismas opciones de seguimiento (ejemplo de código, lección de concepto, material de apoyo, proyecto de referencia)
• Los proyectos de referencia muestran cómo se ve la estructura del proyecto final cuando está completa
• El progreso persiste entre sesiones — retoma donde lo dejaste

Exámenes de Práctica

Exámenes completos de 60 preguntas que simulan la certificación real:

Todos los intentos se guardan con desgloses de puntuación por dominio y tendencias de mejora.

Panel de Progreso

Architect Cert incluye un panel visual con efecto glassmorphism que se renderiza directamente dentro de Claude mediante Claude Preview.

Qué Muestra

• Anillo de Preparación — Porcentaje general de preparación para el examen en un indicador circular de progreso
• Cuadrícula de Dominio — 5 tarjetas con barras de progreso para cada dominio del examen
• Gráfico de Historial de Exámenes — Gráfico de líneas que traza tus puntuaciones de exámenes de práctica a lo largo del tiempo, con la puntuación de aprobación de 720 marcada
• Línea de Tiempo de Actividad Reciente — Tus últimas 10 respuestas con indicadores de correcto/incorrecto
• Progreso del Proyecto Final — Paso de construcción actual y porcentaje de finalización
• Botones de Acción Rápida — Saltar a práctica, examen, plan de estudio o proyecto final

Cómo Abrirlo

You: "Show my dashboard"

Claude: [opens the branded dashboard in Claude Preview]

El panel se puede reabrir en cualquier momento pidiéndole a Claude nuevamente. Siempre refleja tus datos más recientes.

Alternativa de Texto

Para clientes MCP que no admiten Claude Preview, la herramienta del panel también devuelve un resumen de texto con porcentajes de dominio y estadísticas de examen.

Proyectos de Referencia

Architect Cert incluye 6 proyectos de referencia completos — bases de código TypeScript ejecutables que demuestran conceptos de certificación en código real. Cada archivo tiene un comentario de encabezado que lo mapea a declaraciones de tareas específicas.

Cómo Acceder

You: "Show me a reference project for domain 1"

Claude: [returns the project README, file listing, and architecture walkthrough]

Cómo se Conectan con el Flujo de Estudio

Cuando te equivocas en una pregunta, una de las opciones de seguimiento es "Muéstramelo en el proyecto de referencia" — esto te lleva directamente al proyecto del dominio relevante para que puedas ver el concepto implementado en código real. Luego vuelves a tu cuestionario.

Plan de Estudio

Obtén recomendaciones de estudio personalizadas basadas en tu rendimiento, pesos del examen y programación de repetición espaciada.

Enfoque de Dominio con Selección Múltiple

Al solicitar un plan de estudio, puedes elegir dominios específicos para enfocarte usando casillas de verificación:

You: "What should I study next?"

Claude: [shows domain checkboxes — select the ones you want to focus on]
        [generates a personalized study plan with a visual checklist]

El plan de estudio crea una lista de verificación visual para que puedas rastrear tu progreso a través de cada recomendación.

Dominios del Examen

El examen Claude Certified Architect — Foundations cubre 5 dominios:

30 Declaraciones de Tareas

Herramientas

Architect Cert proporciona 18 herramientas MCP que Claude usa para ofrecer la experiencia de estudio:

Flujo de Estudio

Progreso y Planificación

Exámenes de Práctica

Construcción del Proyecto Final

Referencia y Administración

El servidor también registra 8 indicaciones interactivas y 3 tipos de recursos (materiales conceptuales, proyectos de referencia, resumen del examen).

Arquitectura

┌──────────────────────────────────────────────────────────────────────┐
│                           YOUR MACHINE                               │
│                                                                      │
│   ┌──────────────┐       ┌────────────────────────────────┐          │
│   │ Claude Desktop│       │     Architect Cert MCP          │          │
│   │ Claude Code   │◄─────►│                                │          │
│   │ Any MCP client│ stdio │  18 tools                      │          │
│   └──────┬───────┘       │   8 prompts                     │          │
│          │                │   3 resource types              │          │
│          │                └──────────┬─────────────────────┘          │
│          │                           │                                │
│          │         ┌────────────────┼────────────────────┐           │
│          │         │                │                     │           │
│          │   ~/.connectry-      390 questions         6 reference     │
│          │    architect/       30 handouts            projects        │
│          │    progress.db     (bundled JSON/MD)      (bundled TS)     │
│          │                                                            │
│          │  ┌──────────────────────────┐                              │
│          └──► Claude Preview (Dashboard) │                              │
│             │ localhost HTTP server      │                              │
│             └──────────────────────────┘                              │
│                                                                      │
└──────────────────────────────────────────────────────────────────────┘

Componentes Principales

Arquitectura de UI Interactiva

Architect Cert no construye su propia interfaz de chat. En su lugar, instruye a Claude para que use herramientas interactivas integradas:

• AskUserQuestion — Presenta botones clicables para respuestas A/B/C/D, acciones de seguimiento y selección de dominio. Admite selección única (botones de radio), selección múltiple (casillas de verificación) y entrada de texto libre mediante "Otro".
• TodoWrite — Crea listas de verificación de progreso visuales que se actualizan en tiempo real durante evaluaciones, exámenes y construcciones de proyecto final.
• Claude Preview — Renderiza el HTML del panel de vidrio esmerilado en un servidor HTTP local.

Este enfoque funciona en Claude Code y Claude Desktop sin requerir código de UI personalizado en el lado del cliente.

Diseño Anti-Adulación

Este servidor impone una calificación honesta a nivel de protocolo — no solo en las indicaciones:

1. Calificación determinista — gradeAnswer() es una función pura. No interviene ningún LLM en el juicio de corrección.
2. Cumplimiento a nivel de herramienta — La descripción de la herramienta submit_answer instruye a Claude a transmitir los resultados textualmente.
3. Sin crédito parcial — Opción múltiple, una respuesta correcta. Sin "ibas por buen camino".
4. Explicaciones de respuestas incorrectas — Cada opción incorrecta tiene una entrada específica de whyWrongMap que explica la idea errónea.
5. Reglas de la indicación del sistema — Cinco directivas anti-adulación impiden que Claude suavice resultados incorrectos.

Detalles del Banco de Preguntas

Almacenamiento de Datos

• El progreso se almacena localmente en ~/.connectry-architect/progress.db (SQLite, modo WAL)
• Tu configuración de usuario se encuentra en ~/.connectry-architect/config.json (se crea automáticamente en el primer uso)
• Sin nube, sin cuentas, sin telemetría — todo permanece en tu máquina

Contribuciones

¡Agradecemos las contribuciones! Así es como empezar:

# Clone the repo
git clone https://github.com/Connectry-io/connectrylab-architect-cert-mcp.git
cd connectrylab-architect-cert-mcp

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Generate PDF handouts
npm run generate:pdfs

# Run locally
node dist/index.js

Estructura del Proyecto

src/
├── index.ts              # MCP server entry point
├── config.ts             # User config management
├── types.ts              # All TypeScript interfaces
├── data/
│   ├── loader.ts         # Lazy-cached data loading
│   ├── curriculum.json   # 30 task statements
│   ├── questions/        # 390 questions (5 domain files)
│   ├── handouts/         # 30 concept handouts (markdown)
│   ├── criteria.ts       # 30 task statement criteria for capstone validation
│   ├── build-steps.ts    # 18 capstone build step definitions
│   └── system-prompt.ts  # Anti-sycophancy rules
├── db/
│   ├── schema.ts         # SQLite schema (9 tables)
│   ├── store.ts          # Database initialization
│   ├── mastery.ts        # Mastery level calculations
│   ├── answers.ts        # Answer recording
│   ├── review-schedule.ts # SM-2 review scheduling
│   ├── capstone.ts       # Capstone build CRUD operations
│   ├── users.ts          # User management
│   └── exam-attempts.ts  # Practice exam tracking
├── engine/
│   ├── grading.ts        # Deterministic grading
│   ├── spaced-repetition.ts  # SM-2 algorithm
│   ├── question-selector.ts  # Priority-based selection
│   ├── exam-builder.ts       # Practice exam generation
│   └── adaptive-path.ts      # Learning path recommendations
├── tools/                # 18 MCP tool handlers
│   ├── index.ts          # Tool registration
│   ├── elicit.ts         # MCP elicitation helper (graceful fallback)
│   ├── start-assessment.ts
│   ├── submit-answer.ts
│   ├── get-practice-question.ts
│   ├── follow-up.ts
│   ├── get-progress.ts
│   ├── get-curriculum.ts
│   ├── get-section-details.ts
│   ├── get-weak-areas.ts
│   ├── get-study-plan.ts
│   ├── start-practice-exam.ts
│   ├── submit-exam-answer.ts
│   ├── get-exam-history.ts
│   ├── scaffold-project.ts
│   ├── start-capstone-build.ts
│   ├── capstone-build-step.ts
│   ├── capstone-build-status.ts
│   ├── reset-progress.ts
│   └── dashboard.ts
├── ui/
│   ├── server.ts         # Dashboard HTTP server
│   ├── dashboard.html    # Glassmorphism dashboard UI
│   ├── meta.ts           # Quiz widget metadata
│   └── loader.ts         # HTML asset loader
├── prompts/              # 8 MCP prompt definitions
└── resources/            # 3 MCP resource types

projects/
├── capstone/             # All 5 domains — multi-agent support system
├── d1-agentic/           # Domain 1 — agentic loop research coordinator
├── d2-tools/             # Domain 2 — MCP server with tool patterns
├── d3-config/            # Domain 3 — Claude Code configuration layout
├── d4-prompts/           # Domain 4 — extraction & prompt engineering
└── d5-context/           # Domain 5 — context management & reliability

scripts/
└── generate-pdfs.ts      # PDF handout generator

Licencia

MIT © Connectry Labs

Créditos

• Anthropic — Claude y el programa de certificación Claude Certified Architect
• Model Context Protocol — El protocolo que hace esto posible
• better-sqlite3 — SQLite rápido y síncrono para Node.js

_{Hecho con cuidado por Connectry Labs}

GitHub • npm • Architect Cert • Connectry Labs