structured learning path generation for ai agent roles
Generates role-specific learning roadmaps (Algorithm Engineer vs Development Engineer) by organizing 300+ curated resources into sequential, interview-annotated learning paths. Uses numeric prefix-based directory ordering (01-theory → 02-tech-stack → 03-practice → 04-interview) to enforce pedagogical progression, with each topic tagged for job-testing relevance and role applicability. Implements resource aggregation pattern that cites external materials rather than reproducing them, enabling lightweight maintenance while preserving signal quality.
Unique: Dual-track role-specific roadmaps (Algorithm Engineer vs Development Engineer) with explicit interview-testing annotations for every topic, modeled after JavaGuide's proven job-oriented structure but specialized for agent development
vs alternatives: More job-focused and role-differentiated than generic LLM tutorials; provides explicit interview signal rather than just technical depth
curated agent framework comparison and evaluation
Maintains a structured comparison matrix of agent frameworks (LangGraph, CrewAI, AutoGen, etc.) with evaluation criteria covering architecture patterns, memory systems, tool-calling approaches, and production readiness. Implements a reference-aggregation pattern that indexes official documentation and research papers rather than reimplementing framework knowledge, enabling rapid updates as frameworks evolve. Includes 12-factor agent architecture principles and agent evaluation guidelines that provide decision frameworks for framework selection.
Unique: Provides 12-factor agent architecture principles and explicit production-challenge documentation (agent sandbox guide, evaluation complete guide) that go beyond feature comparison to address deployment and operational concerns
vs alternatives: Deeper than marketing comparisons; includes production-specific concerns (sandboxing, evaluation, safety) rather than just feature lists
markdown-to-json resource indexing pipeline
Automates conversion of Markdown documentation into a JSON index consumed by the frontend SPA. Implemented as Python scripts in scripts/ directory that parse Markdown frontmatter, extract topic hierarchies, and generate a searchable index. Enables rapid content updates without manual index maintenance, supporting the resource-aggregation pattern by keeping documentation and index in sync.
Unique: Custom Python pipeline that converts Markdown with role-specific tags (Algorithm Engineer, Development Engineer) into a hierarchical JSON index, enabling role-filtered navigation
vs alternatives: Tightly integrated with AgentGuide's role-specific tagging system; most documentation pipelines don't support role-based content filtering
github pages ci/cd deployment with automated resource generation
Implements a GitHub Actions workflow (.github/workflows/deploy-pages.yml) that automatically triggers resource indexing, builds the SPA, and deploys to GitHub Pages on every commit. Enables continuous deployment of documentation updates without manual build steps. Implements a fully automated pipeline from Markdown source to live website.
Unique: Fully automated pipeline from Markdown commit to live website, including resource indexing and SPA build, with no manual intervention required
vs alternatives: Zero-friction deployment compared to manual build-and-deploy workflows; leverages GitHub Pages free hosting to eliminate infrastructure costs
rag system design and vector database reference
Indexes RAG architecture patterns, vector database options (Pinecone, Weaviate, Milvus, Chroma), and document parsing strategies through curated reference documentation and research papers. Implements a knowledge-aggregation pattern that maps RAG papers to practical implementation guides, connecting theoretical foundations (agentic RAG, GraphRAG) to production tooling. Includes document parsing best practices covering PDF extraction, chunking strategies, and metadata preservation.
Unique: Bridges research papers (agentic RAG, GraphRAG) with practical tooling choices, including explicit document parsing guide that addresses production challenges like heterogeneous formats and metadata preservation
vs alternatives: Connects theoretical RAG advances (agentic RAG, GraphRAG) to implementation choices; most tutorials focus only on basic RAG patterns
context engineering and prompt optimization reference
Provides structured guidance on context window management, prompt engineering patterns, and token optimization strategies for agent systems. Covers context engineering principles (how to structure prompts for agents), memory system design (conversation history, episodic memory, semantic memory), and token budget allocation across multi-turn interactions. Implements a pattern-documentation approach that catalogs proven prompt structures and context management techniques from research and production systems.
Unique: Separates context engineering (how to structure information for agents) from general prompt engineering, with explicit focus on multi-turn agent interactions and memory system design patterns
vs alternatives: More agent-specific than generic prompt engineering guides; addresses memory and context persistence challenges unique to multi-turn agent systems
supervised fine-tuning (sft) and model adaptation guide
Documents SFT strategies for adapting foundation models to agent tasks, including data synthesis approaches, training pipeline design, and evaluation metrics specific to agent behavior. Covers how to generate synthetic training data for agent-specific tasks (tool-calling, reasoning, planning) and how to measure fine-tuning effectiveness. Implements a reference-aggregation pattern linking SFT research papers to practical implementation considerations.
Unique: Focuses specifically on SFT for agent tasks (tool-calling, reasoning, planning) rather than general language model fine-tuning, with emphasis on synthetic data generation for agent-specific behaviors
vs alternatives: Agent-task-specific rather than general SFT guidance; addresses unique challenges of training agents (tool-calling accuracy, reasoning consistency)
agent architecture principles and design patterns
Codifies 12-factor agent architecture principles and design patterns for building production-grade agent systems. Covers agent lifecycle management, error handling, observability, sandboxing, and safety considerations. Implements a pattern-documentation approach that catalogs proven architectural decisions from production systems and research, enabling teams to avoid common pitfalls.
Unique: Provides explicit 12-factor agent architecture framework (analogous to 12-factor app) with dedicated sandbox guide and agent evaluation complete guide, addressing production concerns beyond typical agent tutorials
vs alternatives: Treats agent architecture as a first-class concern with explicit principles; most agent tutorials focus on capability building rather than production architecture
+4 more capabilities