mirror of
https://github.com/rohitg00/ai-engineering-from-scratch.git
synced 2026-09-19 02:42:50 +08:00
main
5 Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
|
|
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 |
||
|
|
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. |
||
|
|
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. |
||
|
|
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. |
||
|
|
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. |