Connectry Architect Cert

Passe no exame de Certified Architect da Claude

Preparação adaptativa para certificação, alimentada pelo Model Context Protocol.
390 questões. Projeto capstone guiado. 30 apostilas de conceitos. 6 projetos de referência. Exames práticos. Painel interativo. Repetição espaçada. Zero bajulação.

Início Rápido • Trilha de Aprendizado • Experiência Interativa • Avaliação • Apostilas • Prática • Projeto Capstone • Exames Práticos • Painel • Projetos de Referência • Ferramentas • Arquitetura

O que é o Architect Cert?

O Architect Cert é um servidor MCP gratuito e de código aberto que transforma o Claude no seu tutor pessoal de certificação para o exame Claude Certified Architect — Foundations. Sem cursos, sem slides, sem videoaulas — basta perguntar ao Claude e estudar.

Ele inclui:

• 390 questões baseadas em cenários em todos os 5 domínios do exame e 30 declarações de tarefas
• Interface interativa clicável — responda às questões com botões A/B/C/D, selecione acompanhamentos, escolha domínios com caixas de seleção — tudo dentro do Claude
• Avaliação com foco em lições — aprenda os conceitos de cada domínio antes de ser testado neles
• Projeto capstone guiado — molde seu próprio projeto e depois construa-o passo a passo enquanto aprende cada declaração de tarefa na prática
• 30 apostilas de conceitos — uma por declaração de tarefa, com exemplos de código e erros comuns
• 6 projetos de referência — codebases TypeScript executáveis demonstrando cada domínio na prática
• Exames práticos — exames ponderados de 60 questões com histórico e tendências de melhoria
• Painel de progresso — painel visual com efeito glassmorphism, níveis de maestria, gráfico de histórico de exames e linha do tempo de atividades
• Acompanhamento visual de progresso — listas de verificação acompanham seu progresso em avaliações, exames e projetos capstone em tempo real
• Acompanhamentos interativos — resposta errada? Clique para ver exemplos de código, lições de conceitos, apostilas ou projetos de referência
• Geração de PDF — apostilas em PDF com a marca e o logotipo do Architect Cert para estudo offline
• Repetição espaçada — algoritmo SM-2 agenda revisões em intervalos ideais
• Correção determinística — correção por função pura, sem julgamento de LLM, zero bajulação

Tudo roda localmente. Sem nuvem, sem contas, sem telemetria.

Início Rápido

1. Instalação

npm install -g connectry-architect-mcp

2. Configure Seu 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. Comece a Estudar

Reinicie seu cliente MCP e comece a conversar:

Trilha de Aprendizado

O Architect Cert foi projetado para seguir uma progressão natural. Aqui está a ordem recomendada:

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

Você pode pular para qualquer etapa a qualquer momento — o sistema se adapta. Mas o caminho acima oferece a experiência mais estruturada.

Experiência Interativa

O Architect Cert usa a interface interativa integrada do Claude para tornar o estudo natural. Sem digitar letras de resposta — basta clicar.

Seleção de Resposta Clicável

Cada questão apresenta botões A/B/C/D clicáveis diretamente no Claude. Você toca na sua resposta em vez de digitá-la. Se a questão incluir código no cenário, uma prévia do código aparece ao lado de cada opção para que você possa consultá-la enquanto decide.

Ações de Acompanhamento

Após cada resposta, botões de acompanhamento clicáveis aparecem:

Após uma resposta errada:

• Entendi, próxima questão
• Explique com um exemplo de código
• Mostre-me a lição de conceito
• Mostre-me a apostila
• Mostre-me no projeto de referência

Após uma resposta correta:

• Próxima questão
• Explique por que as outras estão erradas

Seletor de Domínios com Seleção Múltipla

Ao solicitar um plano de estudos, você pode selecionar vários domínios para focar usando caixas de seleção — sem precisar listá-los pelo nome.

Listas de Verificação de Progresso Visual

Fluxos longos, como a avaliação (15 questões), exames práticos (60 questões) e o projeto capstone (18 etapas), criam uma lista de verificação visual que é atualizada em tempo real conforme você avança. Você sempre sabe onde está e o que falta.

Pular e Outro

Cada seleção de questão inclui um botão Pular para avançar e uma opção Outro para fazer uma pergunta livre. Se você usar "Outro" para perguntar algo, o Claude responde sua pergunta e depois reapresenta a mesma questão do quiz — você nunca perde seu lugar. "Pular" avança para a próxima questão; questões puladas permanecem sem resposta e reaparecerão mais tarde.

Avaliação Inicial

Comece com um diagnóstico de 15 questões (3 por domínio) que determina sua trilha de aprendizado. A avaliação funciona de forma diferente da prática pura:

Fluxo com Foco em Lições

Quando a avaliação chega a um novo domínio pela primeira vez, ela pausa para mostrar a apostila de conceito antes de fazer as perguntas. Isso significa que você aprende as ideias-chave, vê exemplos de código e entende erros comuns antes de ser testado — sem adivinhar às cegas.

O fluxo para cada domínio:

1. A apostila de conceito é exibida (uma vez por domínio)
2. 3 questões apresentadas uma de cada vez (fácil, média, difícil)
3. Cada resposta é corrigida imediatamente com explicação
4. Avance para o próximo domínio

Atribuição de Trilha

Com base na sua precisão geral:

Acompanhamento de Progresso

A avaliação cria uma lista de verificação visual de 15 itens (Q1 a Q15, agrupados por domínio) que é atualizada após cada resposta. Você sempre vê exatamente o quanto já avançou.

Apostilas de Conceitos

Cada declaração de tarefa tem uma apostila de conceito — um documento de estudo estruturado (~500-800 palavras) que cobre:

• Conceito — A ideia central, o modelo mental e quando/por que usar
• Exemplo de Código — TypeScript realista demonstrando o padrão
• Erros Comuns — Os 3-5 erros mais frequentes (que correspondem às respostas erradas do exame)
• Referências — Links para a documentação oficial da Anthropic

Lendo Apostilas no Claude

You: "Show me the handout for task 2.3"

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

Quando as Apostilas Aparecem Automaticamente

• Durante a avaliação — exibidas antes da primeira questão de cada novo domínio
• Após uma resposta errada — "Mostre-me a apostila" é uma das opções de acompanhamento
• Durante o projeto capstone — apostilas relevantes estão disponíveis em cada etapa da construção

Gerando Apostilas em PDF

Gere PDFs com a marca para todas as 30 apostilas para estudo offline:

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

Isso cria 30 PDFs em generated/handouts/ com:

• Logotipo do Architect Cert e rótulo do domínio no cabeçalho
• Formatação limpa com blocos de código com realce de sintaxe
• Rodapé "Connectry LABS — Claude Certified Architect Exam Prep — Free & Open Source"

Prática Adaptativa

Cada questão de prática é selecionada por um algoritmo de três prioridades:

1. Revisões atrasadas — Itens de repetição espaçada com revisão prevista para hoje
2. Áreas fracas — Tópicos onde sua maestria está abaixo de 50%
3. Material novo — Questões novas do seu domínio recomendado

Filtragem

Você pode filtrar questões de prática por domínio e/ou dificuldade:

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

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

Acompanhamentos Interativos

Após cada resposta, você recebe opções de acompanhamento clicáveis. Cada opção aprofunda o conceito — e depois traz você de volta ao seu quiz. Você nunca sai do seu fluxo de estudo para pesquisar algo.

Níveis de Maestria

Cada uma das 30 declarações de tarefa tem um nível de maestria independente:

Repetição Espaçada (SM-2)

O algoritmo SM-2 agenda intervalos de revisão:

• Primeira revisão: 1 dia após responder
• Segunda revisão: 3 dias após a primeira revisão
• Revisões subsequentes: Intervalo anterior x fator de facilidade (começa em 2,5)
• Resposta errada: O intervalo é redefinido e o fator de facilidade diminui em 0,2 (mínimo: 1,3)
• Resposta correta: O fator de facilidade aumenta em 0,1

Questões difíceis voltam com frequência. As fáceis se espaçam para semanas ou meses.

Projeto Capstone Guiado

A maneira mais prática de aprender — construa seu próprio projeto do zero enquanto cobre todas as 30 declarações de tarefas. Em vez de apenas responder perguntas, você arquiteta um sistema real com tema baseado na sua própria ideia.

Como Funciona

A construção do projeto final (capstone) tem três fases:

Fase 1 — Modelagem do Projeto

Você descreve uma ideia de projeto (ex.: "um sistema de revisão de código multiagente"). O Claude analisa sua ideia contra todos os 30 critérios arquiteturais e identifica lacunas. Vocês refinam juntos até que cada declaração de tarefa seja coberta.

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 — Construção Intercalada (18 etapas)

Cada etapa segue o mesmo padrão:

1. Quiz — 2 a 3 perguntas sobre as declarações de tarefas que você está prestes a construir (botões clicáveis A/B/C/D)
2. Construção — O Claude gera o código do arquivo, com tema do seu projeto
3. Explicação — Explicação linha por linha mapeando o código para as declarações de tarefas

Uma lista de verificação visual de 18 etapas acompanha seu progresso em tempo real.

As 18 etapas são construídas incrementalmente:

Cada resposta do quiz alimenta a mesma repetição espaçada e o acompanhamento de domínio do treino regular.

Fase 3 — Revisão Final

Após a etapa 18, você recebe um mapa de cobertura completo: todas as 30 declarações de tarefas, onde cada uma é demonstrada no seu projeto, e seu desempenho no quiz por domínio. Áreas fracas são sinalizadas para estudo adicional.

Ferramentas da Construção Final (Capstone)

Como Isso Se Conecta a Todo o Resto

• As respostas do quiz durante a construção usam a mesma correção submit_answer e o agendamento SM-2
• Após qualquer pergunta do quiz, você pode usar as mesmas opções de acompanhamento (exemplo de código, lição de conceito, apostila, projeto de referência)
• Os projetos de referência mostram como a estrutura do capstone fica quando completa
• O progresso persiste entre sessões — continue de onde parou

Exames de Prática

Exames completos de 60 perguntas que simulam a certificação real:

Todas as tentativas são salvas com detalhamento de pontuação por domínio e tendências de melhoria.

Painel de Progresso

O Architect Cert inclui um painel visual com efeito glassmorphism que é renderizado diretamente no Claude via Claude Preview.

O Que Ele Mostra

• Anel de Prontidão — Porcentagem geral de prontidão para o exame em um indicador circular de progresso
• Grade de Domínio — 5 cartões com barras de progresso para cada domínio do exame
• Gráfico de Histórico de Exames — Gráfico de linhas plotando suas pontuações nos exames de prática ao longo do tempo, com a nota de aprovação 720 marcada
• Linha do Tempo de Atividade Recente — Suas últimas 10 respostas com indicadores de certo/errado
• Progresso do Capstone — Etapa de construção atual e porcentagem de conclusão
• Botões de Ação Rápida — Ir para prática, exame, plano de estudo ou capstone

Como Abrir

You: "Show my dashboard"

Claude: [opens the branded dashboard in Claude Preview]

O painel pode ser reaberto a qualquer momento pedindo novamente ao Claude. Ele sempre reflete seus dados mais recentes.

Alternativa em Texto

Para clientes MCP que não suportam Claude Preview, a ferramenta do painel também retorna um resumo em texto com porcentagens de domínio e estatísticas de exame.

Projetos de Referência

O Architect Cert inclui 6 projetos de referência completos — bases de código TypeScript executáveis que demonstram conceitos de certificação em código real. Cada arquivo tem um comentário de cabeçalho mapeando-o para declarações de tarefas específicas.

Como Acessar

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

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

Como Eles Se Conectam ao Fluxo de Estudo

Quando você erra uma pergunta, uma das opções de acompanhamento é "Mostre-me no projeto de referência" — isso leva você direto ao projeto de domínio relevante para ver o conceito implementado em código real. Depois, você volta ao seu quiz.

Plano de Estudo

Receba recomendações de estudo personalizadas com base no seu desempenho, pesos do exame e cronograma de repetição espaçada.

Foco em Domínios com Seleção Múltipla

Ao solicitar um plano de estudo, você pode escolher domínios específicos para focar usando caixas de seleção:

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]

O plano de estudo cria uma lista de verificação visual para que você acompanhe seu progresso em cada recomendação.

Domínios do Exame

O exame Claude Certified Architect — Foundations cobre 5 domínios:

30 Declarações de Tarefas

Ferramentas

O Architect Cert fornece 18 ferramentas MCP que o Claude usa para entregar a experiência de estudo:

Fluxo de Estudo

Progresso e Planejamento

Exames de Prática

Construção Final (Capstone)

Referência e Administração

O servidor também registra 8 prompts interativos e 3 tipos de recursos (apostilas de conceitos, projetos de referência, visão geral do exame).

Arquitetura

┌──────────────────────────────────────────────────────────────────────┐
│                           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 Principais

Arquitetura de UI Interativa

O Architect Cert não cria sua própria UI de chat. Em vez disso, ele instrui o Claude a usar ferramentas interativas integradas:

• AskUserQuestion — Apresenta botões clicáveis para respostas A/B/C/D, ações de acompanhamento e seleção de domínio. Suporta seleção única (botões de rádio), seleção múltipla (caixas de seleção) e entrada de texto livre via "Outro".
• TodoWrite — Cria listas de verificação de progresso visuais que são atualizadas em tempo real durante avaliações, exames e construções capstone.
• Claude Preview — Renderiza o HTML do dashboard glassmorphism em um servidor HTTP local.

Essa abordagem funciona no Claude Code e no Claude Desktop sem exigir nenhum código de UI personalizado no lado do cliente.

Design Anti-Bajulação

Este servidor impõe avaliação honesta no nível do protocolo — não apenas em prompts:

1. Avaliação determinística — gradeAnswer() é uma função pura. Nenhum LLM está envolvido no julgamento da correção.
2. Imposição no nível da ferramenta — A descrição da ferramenta submit_answer instrui o Claude a repassar os resultados literalmente.
3. Sem crédito parcial — Múltipla escolha, uma resposta correta. Sem "você estava no caminho certo".
4. Explicações de respostas erradas — Cada opção incorreta tem uma entrada whyWrongMap específica explicando o equívoco.
5. Regras do prompt do sistema — Cinco diretrizes anti-bajulação impedem o Claude de suavizar resultados incorretos.

Detalhes do Banco de Perguntas

Armazenamento de Dados

• O progresso é armazenado localmente em ~/.connectry-architect/progress.db (SQLite, modo WAL)
• Sua configuração de usuário fica em ~/.connectry-architect/config.json (criada automaticamente na primeira execução)
• Sem nuvem, sem contas, sem telemetria — tudo permanece na sua máquina

Contribuindo

Aceitamos contribuições! Veja como começar:

# 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

Estrutura do Projeto

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

Licença

MIT © Connectry Labs

Créditos

• Anthropic — Claude e o programa de certificação Claude Certified Architect
• Model Context Protocol — O protocolo que torna isso possível
• better-sqlite3 — SQLite rápido e síncrono para Node.js

_{Feito com carinho por Connectry Labs}

GitHub • npm • Architect Cert • Connectry Labs