5 Commits

Author SHA1 Message Date
Rohit Ghumare ed6d0c0196 feat: add agent skills track and stateless MCP curriculum (#422)
* feat(phase-13/22): teach portable agent skill contracts

Agent skills need a portable contract before host-specific metadata and runtime policy can be reasoned about.

* fix(phase-13/23): make the ecosystem capstone accurate

The capstone should model current A2A operations, portable artifact metadata, and deterministic trace timing.

* feat(phase-13/24): teach skill discovery and disclosure

A useful skill catalog needs explicit scope precedence and bounded progressive disclosure before instructions are loaded.

* feat(phase-13/25): teach invocation policy and routing

Human, model, application, and skill activation need separate policy decisions before relevance ranking can be trusted.

* feat(phase-13/26): teach skill sandbox and trust boundaries

Skill instructions are untrusted input, so authority must remain host-owned and every filesystem, network, and command boundary must fail closed.

* feat(phase-13/27): add the skill release gate

A distributable skill needs adversarial structure, routing, safety, artifact, provenance, installation, and portability evidence before release.

* feat(skills): install and render complete skill bundles

Progressive-disclosure skills must keep companion references, scripts, assets, and evals intact across discovery, installation, and lesson rendering.

* docs(curriculum): index the agent skills mini-course

The expanded Phase 13 sequence needs consistent lesson links, durations, translations, and shared terminology across every learner entry point.

* feat(certification/11): teach stateless MCP integration

Certification learners need the same stateless wire model as the production curriculum.

* feat(phase-11/14): modernize MCP protocol contracts

The foundational MCP lesson must no longer teach the removed session lifecycle.

* fix(phase-13/01): align tool terms with stateless MCP

The tool interface introduction should point to the current protocol vocabulary.

* feat(phase-13/06): teach stateless MCP fundamentals

Learners need the current per-request contract before building clients or servers.

* feat(phase-13/07): build a stateless MCP server

The server lab should model the protocol that new implementations actually ship.

* feat(phase-13/08): build a stateless MCP client

The client lab must negotiate every request without relying on session state.

* feat(phase-13/09): teach current Streamable HTTP

Transport examples need the current POST-only lifecycle and notification behavior.

* feat(phase-13/10): teach stateless resources and prompts

Resource and prompt discovery must reflect stateless cache and result contracts.

* feat(phase-13/11): teach per-request sampling

Sampling calls must carry current capabilities and stateless response semantics.

* feat(phase-13/12): teach roots and elicitation retries

Elicitation retries and roots handling need current capability and MRTR boundaries.

* feat(phase-13/13): teach stateless MCP tasks

Task storage and subscriptions must survive cross-instance stateless requests.

* feat(phase-13/14): update MCP Apps contracts

Apps learners need current bridge, subscription, and discovery boundaries.

* feat(phase-13/15): update MCP threat boundaries

Threat modeling must cover current routing and MRTR state boundaries.

* feat(phase-13/16): update MCP OAuth contracts

OAuth examples must bind issuers and resources while using current errors.

* feat(phase-13/17): update gateway and registry contracts

Registry admission must separate publication identity from runtime discovery.

* feat(phase-13/18): teach production MCP authentication

Production auth should implement real PKCE, CIMD, and resource-bound caching.

* docs(phase-13/22): add a runnable skill quickstart

Beginners need an exact repository-root path from bundle inspection to host use.

* fix(phase-13/23): make the capstone stateless

The ecosystem capstone must compose the same current contracts taught upstream.

* docs(phase-13/24): clarify host discovery limits

Learners should distinguish known context budgets from host fallback behavior.

* docs(phase-13/26): clarify sandbox prerequisites

The safety lab needs explicit prerequisites and a viable conceptual fallback.

* docs(phase-13/27): add real-host release evidence

A production claim should require installed-host evidence beyond deterministic fixtures.

* docs(phase-16/02): update MCP legacy comparison

The interoperability comparison should use the current stateless MCP lifecycle.

* feat(phase-19/13): modernize the MCP registry capstone

The production capstone must separate Registry publication from stateless runtime discovery.

* docs(curriculum): index agent skills and stateless MCP

Learners need one coherent route through the skills track and current MCP sequence.

* feat(skills): add a focused agent skills learner path

A dedicated route removes placement and navigation friction for focused learners.

* feat(mcp): add production engineering track

* fix(cert-11): harden MCP integration contract

* fix(phase-11-14): classify MCP handler failures

* fix(mcp-07): validate JSON-RPC request identifiers

* fix(mcp-08): reuse strict response decoding

* fix(mcp-09): harden HTTP transport boundaries

* fix(mcp-11): isolate returned tool descriptors

* fix(mcp-12): make continuation state single-use

* fix(mcp-14): align lesson response metadata

* fix(mcp-15): expire and consume continuation state

* fix(mcp-16): bind OAuth enrollment and code exchange

* fix(mcp-18): enforce redirect and code lifetimes

* fix(mcp-23): validate task identifiers

* fix(skills-24): clarify discovery boundaries

* fix(skills-25): deny unknown invocation actors

* fix(skills-26): validate approval policy shape

* fix(mcp-28): terminate unsafe cursor pagination

* fix(mcp-29): preserve completed request state

* fix(mcp-30): require secure remote endpoints

* fix(mcp-31): strengthen conformance checks

* fix(agent-skills): align route prerequisites

* fix(scripts): harden skill bundle installation

* fix(site): validate learning and artifact boundaries

* fix(course): address review edge cases

* fix(mcp): tighten notification and redirect validation

* fix(mcp): secure reproducible lesson state

* fix(mcp): use required lesson header comments
2026-08-23 18:01:53 +01:00
Rohit Ghumare 69502d8e93 feat: add AI-native certification curriculum and learning surfaces (#395)
* fix(i18n): force-add translated lessons past main's inherited .gitignore

The dispatched backfill (run 30768876598, 100 shards, all green) published
nothing: the translations branch was never created (404). Every shard's
publish step logged "no changes".

Root cause: when origin/translations doesn't exist yet, the publish step
creates it from the current checkout, which is main's tree, .gitignore
included. main's .gitignore intentionally excludes i18n/*/phases/ and
i18n/*/.cache/ to keep lesson translations off main, but that same rule
silently drops the plain `git add "i18n/$LANG_CODE"` inside the new
translations-branch worktree, so nothing was ever staged, committed, or
pushed across all 100 jobs.

Reproduced locally (a repo with the same .gitignore + the same add call
reports "no changes"; git add -f stages correctly) before applying the fix.

Force-add: the translations branch exists specifically to hold this content.

* feat(cert/00): add certification strategy

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/01): add product and model selection

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/02): add model routing and token economics

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/03): add prompting and task decomposition

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/04): add context, memory, and caching

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/05): add output evaluation and validation

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/06): add governance and responsible use

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/07): add workflow design and handoffs

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/08): add Messages API lifecycle

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/09): add defensive structured outputs

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/10): add tool use and agent loops

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/11): add MCP server integration

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/12): add Agent SDK harnesses and hooks

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/13): add application security controls

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/14): add evals and observability

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/15): add Claude Code team workflows

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/16): add multi-agent orchestration

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/17): add sessions, subagents, and context

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/18): add resilient tool contracts

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/19): add Claude Code skills and CI

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/20): add extraction, batch, and review

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/21): add long-context reliability

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/22): add discovery and SLA design

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/23): add architecture tradeoffs

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/24): add RAG evidence pipelines

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/25): add least-privilege integrations

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/26): add production operations

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/27): add enterprise governance

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/28): add lifecycle communication

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/29): add associate capstone

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/30): add developer capstone

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/31): add architect foundations capstone

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* feat(cert/32): add architect professional capstone

Adds the lesson, runnable lab, deterministic tests, practice, and inspectable artifacts for this certification topic.

* chore(cert): define curriculum contract

Documents certification lesson invariants and keeps the AI tutor wrapper while excluding generated site data.

* docs(cert): define program and verified sources

Adds the independent curriculum policy, onboarding, prerequisites, research notes, and dated source register.

* feat(cert/ccao-f): add associate route and practice

Maps the associate blueprint to an ordered route, diagnostic, and original full-length practice assessment.

* feat(cert/ccdv-f): add developer route and practice

Maps the developer blueprint to an ordered route, diagnostic, and original full-length practice assessment.

* feat(cert/ccar-f): add architect foundations route

Maps the architect foundations blueprint to an ordered route, diagnostic, and original full-length practice assessment.

* feat(cert/ccar-p): add architect professional route

Maps the architect professional blueprint to an ordered route, diagnostic, and original full-length practice assessment.

* feat(skill): add AI-native certification tutor

Teaches certification routes step by step in compatible agent harnesses and keeps learner state outside the book workflow.

* test(cert): enforce certification contracts

Audits lesson, assessment, reference, and answer-position invariants and runs all certification labs in CI.

* docs(readme): publish certification entry points

Adds the GitHub tutor and website entry points across the canonical README and synchronized translations.

* feat(glossary): expand the learning reference

Adds deeper original definitions, learning areas, source links, filters, and navigable term detail.

* feat(site): redesign the interactive roadmap

Keeps the canonical top-to-bottom dependency graph while adding branded focus, path guidance, and reliable navigation.

* feat(site): integrate interactive learning surfaces

Adds certification routes, lessons, assessments, progress, navigation, artifact rendering, narration fixes, and deploy routing.
2026-08-09 15:45:01 +01:00
Rohit Ghumare ebc5fff881 feat: add 18 glossary terms from new Phase 3 + Phase 11 lessons
New terms: Activation Function, AdamW, Autograd, Batch Size, Chunking,
Cosine Similarity, Cross-Entropy, Few-Shot, Function Calling, Guardrails,
JAX, Precision & Recall, Prompt Injection, QLoRA, ROUGE, Semantic Search,
Streaming, System Prompt, Tensor

Glossary now has 83 terms (was 65). Site data.js rebuilt.
2026-04-02 12:04:25 +01:00
Rohit Ghumare ba54dd750e Expand glossary to 60+ terms, add 20 myth busters
New myths.md with 20 common AI misconceptions busted: "AI understands
language", "more parameters = smarter", "you need a PhD in math",
"temperature = creativity", "fine-tuning adds knowledge", etc.

Glossary expanded from 25 to 60+ terms covering: Adam, autoregressive,
CNN, contrastive learning, dropout, eigenvalue, encoder, epoch, GAN,
hyperparameter, inference, inductive bias, KV cache, latent space,
learning rate, loss function, mixed precision, MoE, NaN, normalization,
overfitting, parameter, perplexity, quantization, ReLU, self-attention,
SFT, softmax, temperature, transfer learning, VAE, weight decay, etc.
2026-03-19 17:29:26 +05:30
Rohit Ghumare 691745d47b Add glossary with 25+ AI terms demystified
Each term includes what people commonly say vs what it actually means,
plus origin of the name. Covers agent, attention, backpropagation,
embedding, GPT, LLM, MCP, RAG, RLHF, transformer, and more.
2026-03-19 00:07:40 +05:30