Model or dataset
adongwanai/AgentGuide avatar
adongwanai/AgentGuide

AgentGuide: A Job-Oriented Study Path for AI Agent Engineers

AI Agent development guide: LangGraph in practice, advanced RAG, switching careers into large models, LLM interview prep, algorithm engineer interview question bank, reinforcement learning, data synthesis. https://adongwanai.github.io/AgentGuide

11,970 stars1,132 forksMDXCC-BY-4.0

At a glance

What is it?
AgentGuide is an open-source, Chinese-language knowledge base that maps AI Agent development, RAG, and post-training topics to interview prep and resume building. It is a curated roadmap, not a runnable framework, and its value depends on how well its claims match your job target.
Who is it for?
Adopt AgentGuide if you are a Chinese-speaking engineer or researcher targeting AI Agent roles and you want a structured, interview-focused syllabus that links concepts like LangGraph, RAG, and GRPO to resume and interview preparation. Do not adopt it if you need hands-on code, runnable examples, or English documentation, because this repository is primarily a curated index of links and notes, not a tutorial you can execute.
Can I use it commercially?
Yes, with credit. CC-BY-4.0 allows commercial use as long as you credit the authors and indicate what you changed. It is written for creative content, so check how it applies to any code.
Is it still maintained?
Yes. The repository last received commits 9 days ago.
What is it written in?
Mainly MDX, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on November 14, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • adongwanai/AgentGuide11,970 ★ · +2,542
Star history
Repository2026-09-102026-11-14
adongwanai/AgentGuide9.4k12k

2,542 Stars in the last 65 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial analysis

What AgentGuide Actually Is

AgentGuide is a knowledge base and learning roadmap, not a software library or framework. The README describes it as an open-source guide for AI Agent engineering, research, and job hunting, explicitly modeled after JavaGuide. It targets people who can call a model and connect a tool but struggle with long-running agent tasks that stall, loop, or lose state. The intended audience is job seekers for roles like AI Agent algorithm engineer, AI Agent development engineer, and RAG system engineer. The repository organizes content into development and algorithm tracks, with a third track for research frontiers. It curates external resources rather than creating original tutorials, following a principle stated in the README: reference existing high-quality courses and papers instead of reinventing them. That makes it a directory with opinions, not a self-contained course.

The Core Mechanism: Learning Paths Tied to Job Outcomes

The organizing idea is that every piece of knowledge is annotated with how it appears in interviews and how it should appear on a resume. The README lists a 1-2-5 framework for job hunting, an 8-stage learning output plan, and a 5-step method for turning projects into resume entries. There are separate roadmaps for development and algorithm roles, with estimated durations of 8-12 weeks and 10-15 weeks respectively. The content spans a wide stack: agent harness topics like context engineering and memory, tools and protocols like MCP and A2A, RAG variants including GraphRAG and multimodal RAG, and post-training methods such as SFT, DPO, and GRPO. Each section is meant to answer three questions: what to learn, how it is tested in an interview, and how to write it on a resume. This is a study guide with a feedback loop into the hiring process, which is unusual for open-source technical documentation.

How to Navigate and Use the Repository

The README provides a quick start that claims a 10-minute setup to run a first agent. Navigation happens through markdown files in a docs directory. The entry points are three links: a development learning roadmap, an algorithm roadmap, and a research frontiers section. A full documentation navigation index is available at docs/README.md, and a beginner quick start is at docs/00-getting-started/README.md. The repository also links to a separate project called learn-workbuddy, which is a clean-room teaching reproduction of a desktop agent harness. For interview preparation, there is a directory of frontier interview guides covering topics like self-evolving agents and agentic reinforcement learning. The FAQ file is linked for common questions. Since the repository is primarily markdown, running it means opening files in a browser or editor, not executing code.

What It Covers: From Agent Loops to Post-Training

The content map in the README is broad. It covers agent application frameworks like LangGraph, OpenAI Agents SDK, AutoGen, and CrewAI, but also lower-level harness concerns: context compression, prompt caching, tool schemas, permission levels, sandboxing, and trace replay. For RAG, it lists document parsing tools like Docling and MinerU, vector databases like Milvus and Qdrant, and evaluation frameworks like RAGAS and Promptfoo. For post-training, it includes SFT, LoRA/QLoRA, DPO, and GRPO, along with trajectory data synthesis. The README claims coverage of the full stack from model fine-tuning to application deployment. A key point is that the guide does not bind to a single framework, which is a deliberate choice to prepare readers for a changing ecosystem rather than a specific tool.

The Interview Question Bank and Its Limitations

A central selling point is the interview question bank, described as containing over 1500 questions and interview experiences. The README also mentions system design questions and programming problems. The claim of 1500 questions is a number, not evidence of usefulness. Interview questions for AI Agent roles are likely to become outdated quickly as the field evolves. The README does mention that the project is continuously updated and welcomes contributions, but there is no changelog or versioning visible. For a job seeker, the risk is spending time on questions that do not match current hiring practices at specific companies.

A Real Alternative: Build a Project Instead of Reading a Guide

The most direct alternative to AgentGuide is not another guide but a hands-on project like the author's own learn-workbuddy, which is linked in the README. That project is a clean-room teaching reproduction of a desktop agent harness, covering agent loops, tool calling, context engineering, and memory. The difference in approach is fundamental: AgentGuide tells you what to learn and how it will be tested, while learn-workbuddy gives you code to write and run. For interview preparation, having a working project with measurable results often carries more weight than reading a roadmap. Another alternative is the official documentation of frameworks like LangGraph or OpenAI Agents SDK, which provide runnable examples and API references. Those docs are narrower but deeper, and they let you verify claims directly. If you need to demonstrate skill to an interviewer, a finished project with a baseline and failure analysis is more convincing than a list of topics you have read about.

Maintenance, License, and Cost of Adoption

The repository has no declared license, which is a significant issue for adoption. Without a license, you have no legal permission to reuse the content beyond reading it, even if it is publicly accessible. The README states that all content is permanently free and open source, but that statement is not a license. If you plan to copy sections into your own study materials or share them widely, you need to contact the author or wait for a license to be added. The last push to the repository was on 2026-10-31, which suggests active maintenance, but there are no releases tagged, so you cannot track changes through version numbers. The primary language is MDX, which means the content is written in Markdown with JSX components, likely for a documentation site. The cost of adoption is mainly time: reading through the roadmap and following links to external resources. The maintenance burden on your side is low.

Editorial conclusion

Adopt AgentGuide if you are a Chinese-speaking engineer or researcher targeting AI Agent roles and you want a structured, interview-focused syllabus that links concepts like LangGraph, RAG, and GRPO to resume and interview preparation. Do not adopt it if you need hands-on code, runnable examples, or English documentation, because this repository is primarily a curated index of links and notes, not a tutorial you can execute. Before relying on it, verify that the linked external resources are still current, since AI frameworks change quickly and the last push is dated 2026, but the content may reference tools that have evolved since then. Also confirm that the interview questions match the specific companies and role levels you are targeting, because the repository does not provide evidence of how recently or thoroughly those questions were validated.

Frequently asked questions

Is AgentGuide a course, a framework, or a website?

It is a documentation repository whose primary language is MDX, published as a static site at https://adongwanai.github.io/AgentGuide. Its top-level tree has no package manifest. The value it offers is the order it gives the reading in.

Can I run an agent from AgentGuide's examples?

Not directly. The examples directory holds examples/eval-cases.jsonl, examples/trace-schema.json, examples/minimal-agent-loop.md, a tool card template and a project README template, and the top-level tree has no package.json, pyproject.toml or requirements.txt.

Can I copy AgentGuide content into my own course or internal docs?

The repository reports an unknown license and no LICENSE file appears in its top-level tree, so no terms are stated for the prose. The README calls all content permanently free. Ask the author before copying or translating it.

How current is AgentGuide, and can I pin a version?

The last push to main was on 2026-10-31 and the repository has no GitHub releases, so there is no tag or dated artifact to compare against. A path you bookmarked under docs/ can change without any version marker telling you.

Official sources

  1. adongwanai/AgentGuide on GitHub
  2. Issues
  3. README
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/adongwanai-agentguide.svg)](https://hysenlabs.com/projects/adongwanai-agentguide)

Star history chart for your README

markdown
[![Star history](https://hysenlabs.com/chart/adongwanai-agentguide.svg)](https://hysenlabs.com/projects/adongwanai-agentguide)

Was this useful?