AgentBase
Source-backed knowledge for AI-assisted teams
“Hôm nay mình giới thiệu AgentBase: cách mình biến context nằm rải rác trong nhiều repository thành knowledge dùng chung, có nguồn và có thể được team sửa. Mình sẽ bắt đầu từ vấn đề sản phẩm, xem một kết quả cụ thể, rồi mới giải thích cơ chế đủ để đánh giá nó có đáng tin hay không.”
VẤN ĐỀ
02 / 24
THE CONTEXT GAP
Context nằm giữa
các repository.
Source có authority trong từng repo. System behavior lại đi qua dependency, event và ownership boundary.
MULTIrepository change
EVENTScross boundaries
REPEATrebuild context
PRODUCT / DELIVERYKhó thấy đúng impact
ENGINEERING / AGENTPhải dựng lại dependency
AGENTBASE / PROBLEM SPACE
02
“Team có thể sở hữu nhiều repository độc lập, nhưng một feature hiếm khi dừng ở một boundary. PM cần biết phạm vi, engineer cần biết dependency, reviewer cần biết kết luận đến từ đâu. Nếu context đó chỉ tồn tại trong một lần điều tra hoặc một cuộc chat, phase sau lại dựng lại và có thể đi đến một phiên bản khác.”
AGENTBASE LÀ GÌ?
03 / 24
PRODUCT PROMISE
Một mental model
đơn giản.
Shared Markdown knowledge, được kết nối với AI agent qua MCP.
KNOWLEDGE BASEMarkdownknowledge
↔MCP
CONSUMERAI Agentask · retrieve · use
THREE PROPERTIESSource-backed · Reviewable · Compounding
AGENTBASE / INTRODUCTION
03
“Ở mức đơn giản nhất, knowledge vẫn là Markdown để team đọc, diff và sửa bằng Git. MCP là đường truy cập có contract cho agent. Agent tìm và tổng hợp context, nhưng không tự biến câu trả lời của mình thành knowledge dùng chung. Ba thuộc tính mình theo đuổi là có nguồn, review được và build up theo thời gian.”
IROCO2 · ƯỚC TÍNH PHÁT THẢI CLOUD04 / 24
CUR = AWS COST AND USAGE REPORT
Từ yêu cầu mơ hồ
đến đúng điểm bắt đầu.
CHANGE REQUESTRetry và visibility cho luồng CUR Analyzer → backend sẽ chạm vào đâu?
REPOSITORYIroco2 Lambdas
→
BOUNDARYAnalyzer SQS
→
REPOSITORYIroco2 Backend
→
RESULTKết quả phân tích
KNOWNproducer · consumer · owning repositories
OPENdeployed identity · retry policy · recovery owner
Không phải câu trả lời hoàn chỉnh — là đúng điểm bắt đầu.
AGENTBASE / PROBLEM → PROOF04
“Với câu hỏi này, Published Hub đưa ra hai repository và producer/consumer evidence liên quan thay vì để agent scan mọi repository ngay từ đầu. Nó đồng thời phân biệt cấu hình queue trong source với identity triển khai thật. Identity AWS được mock; policy vận hành mong muốn và người chịu trách nhiệm còn cần xác nhận. Giá trị không phải là giả vờ đã có đáp án hoàn chỉnh; giá trị là cả product và engineering cùng bắt đầu từ một scope có thể kiểm tra.”
THỨ MÌNH CẦN
05 / 24
PERSISTENT · COMPOUNDING
Knowledge phải được
tích lũy.
Không đọc và dựng lại mọi thứ từ đầu sau mỗi câu hỏi.
“The wiki is a persistent,
compounding artifact.”
ANDREJ KARPATHY · LLM WIKI
MỖI CÂU HỎIRaw sources → Retrieve → Tổng hợp lạiKnowledge bị dựng lại
VS
LLM WIKISources + Questions → Linked MarkdownKnowledge tiếp tục lớn dần ↗
AGENTBASE / KNOWLEDGE PRINCIPLE
05
“Một câu trả lời tốt vẫn mất giá trị nếu phase sau phải dựng lại. LLM Wiki đưa ra ý tưởng quan trọng: wiki là artifact bền và compound. AgentBase áp dụng hướng đó cho system knowledge, nhưng thêm source evidence, lifecycle và publication authority để team có thể tin và sửa nó.”
FOUNDATION · ENOUGH TECHNOLOGY TO TRUST THE STORY06 / 24
OPEN STRUCTURE · CONTROLLED ACCESS · VERIFIABLE CLAIMS
Ba foundation.
Một knowledge lifecycle.
01 · STRUCTUREOKFMarkdown + metadata
portable knowledge
02 · ACCESSMCPcontract tools
agent integration
03 · AUTHORITYExact sourcerepo · revision
path · line span
AGENTreason · investigate · authorMCPvalidate boundariesHUMANSreview · publish
AGENTBASE / FOUNDATION06
“OKF cho mình một convention mở dựa trên Markdown và metadata thay vì format chỉ AgentBase hiểu. MCP cung cấp đường truy cập có contract cho agent. Code Graph có thể giúp điều hướng, nhưng exact source ở revision đã khóa mới là evidence. Sự phân vai quan trọng hơn tên công nghệ: agent reasoning, MCP giữ boundary và con người giữ publication authority.”
KNOWLEDGE LIFECYCLE · AUTHORITY STAYS EXPLICIT07 / 24
SOURCE → SHARED KNOWLEDGE
Agent chuẩn bị.
Con người quyết định.
AUTHORITYExact
sourcerepo · revision · lines
→
AGENT + MCPReviewable
proposalinvestigate · author · validate
→
HUMAN CONFIRMATIONConfirm
Publishreview material changes
→
HUMAN REVIEWPublished
HubDirect · or PR policy
VALIDcontract-compliant, not necessarily complete
MCP LIMITnever approves or merges
AGENTBASE / LIFECYCLE07
“Agent điều tra source và viết vào workspace có cấu trúc. MCP validate citation, relation và schema, nhưng một proposal hợp lệ vẫn có thể chưa đầy đủ. Finalize khóa đúng bytes để inspect; người dùng xem thay đổi quan trọng rồi xác nhận Publish. Theo policy của Hub, MCP đẩy một commit hoàn chỉnh và ghi nhận Published, hoặc tạo PR để team merge rồi sync. Không còn bước Accept hay Local Draft bắt buộc. Xác nhận chia sẻ không có nghĩa kiểm chứng hết mọi câu hay phần bỏ sót.”
PRODUCT DEMO · ONE CONTROLLED STORY08 / 24
IROCO2 DOMAIN
Một yêu cầu minh hoạ
đi qua AgentBase thế nào?
CHANGE REQUEST
Cải thiện retry và khả năng theo dõi lỗi cho luồng CUR Analyzer → backend.
Yêu cầu ngắn · impact xuyên repository
01IMPACTNó chạm vào đâu?
→
02CONFIDENCEFact và unknown là gì?
→
03HANDOFFPhase tiếp theo nhận gì?
FEATURE DISCOVERY→DIAGRAM→DOMAIN HUB→TASK PLANNING
AGENTBASE / DEMO SETUP08
“Đây là một yêu cầu dễ đọc nhưng chưa đủ để implement. Trước hết Feature Discovery cần xác định impact surface và câu hỏi còn mở. Domain Hub giúp con người review route và evidence. Sau khi owner quyết định policy, Task Planning mới đi vào exact source của repository liên quan.”
ỨNG DỤNG · XÁC ĐỊNH PHẠM VI09 / 24
HUB FIRST · SOURCE LATER
Discovery bắt đầu bằng
đúng boundary.
MINH HOẠ · KHÔNG PHẢI TRANSCRIPT
YOURetry và visibility cho luồng CUR Analyzer → backend sẽ chạm vào đâu?
AGENTMình sẽ bắt đầu từ Published Hub của domains/iroco2.
RESULT2 repositories · producer + consumer evidence
PUBLISHED IMPACT SURFACEqualification · 040eb38df7fa
REPOSITORYIroco2 LambdasCUR Analyzer
→
BOUNDARYAnalyzer SQSsource-backed · AWS mock
→
REPOSITORYIroco2 BackendSQS consumerAnalysisEstimates
STILL OPENDeployed identity?Desired retry policy?Alarm?Recovery owner?
DIAGRAM SHOWSaccepted scopeEVIDENCE BOUNDSwhat knowledge can claim
AGENTBASE / FEATURE DISCOVERY09
“Agent bắt đầu từ Published Hub thay vì scan source không giới hạn. Route minh hoạ dựa trên knowledge đã Published; hội thoại này không phải transcript của một lần chạy agent. Những phần chưa có evidence không được điền bằng suy đoán; chúng được giữ như điều cần xác nhận. Diagram cho thấy accepted scope, còn evidence boundary giới hạn điều agent được phép kết luận.”
DOMAIN HUB · HUMAN-READABLE PROJECTION10 / 24
FROM MAP TO EVIDENCE
Con người có thể
drill down.
Published Domain · Iroco2AWS MOCK · 040eb38df7fa
01Choose a viewSystem map · By repository
02Explore connectionssearch · select · focus
03Inspect evidencesource · provenance · commit
DOMAIN HUBreview & exploreAUTHORITYPublished OKF + source citations
AGENTBASE / DOMAIN HUB10
“Domain Hub là projection tĩnh của Published OKF. System map ưu tiên kết nối; By repository nhóm theo nơi chứa source, không phải deployment boundary. Embedded resource bật sẵn; người xem có thể thu gọn, tìm node, bấm các card kết nối và đọc evidence. Theme chỉ đổi cách trình bày. Thiếu cạnh không chứng minh không có dependency. Screenshot này được build từ Published Iroco2 bằng compact Profile hiện tại sau deep refresh và một provider qualification mock; nó không phải claim về runtime production. Authority vẫn là Published OKF và exact source citation bên dưới.”
ỨNG DỤNG · CHUẨN BỊ KẾ HOẠCH11 / 24
FROM SHARED SCOPE TO EXACT SOURCE
Knowledge thu hẹp.
Source quyết định.
CODE GRAPH→EXACT SOURCE
T1Confirm deployed queueLambdas producer · backend consumer
AWS mock → verify live
T2Retry / redrivecandidate: Lambdas Terraform + backend listener
review existing policy
T3Operational visibilityalarm · notification · runbook
acceptance criteria
EACH TASK CARRIESdependency · acceptance · citation · remaining unknown
AGENTBASE / TASK PLANNING11
“Sau khi owner chốt retry policy, alarm và recovery ownership, Task Planning chọn Lambdas và backend để điều tra. Danh sách task ở đây là minh hoạ; identity triển khai thật vẫn phải kiểm tra vì provider observation dùng mock. Code Graph giúp tìm producer, consumer và dependency path, nhưng exact source mới quyết định file, test và thay đổi. AgentBase cung cấp bounded context; planning workflow vẫn sở hữu deliverable và approval của nó.”
UPDATE KNOWLEDGE · ONE INTENTION12 / 24
FAST BY DEFAULT · RECOVER WHEN NEEDED
Knowledge thay đổi.
Knowledge còn thiếu.
DEFAULTCập nhật thay đổiExact Git delta
new + changed evidence
FAST PATH
EXPLICIT RECOVERYBổ sung phần thiếuWeak or sparse coverage
source may be unchanged
BOUNDED PATH
USER INTENTAdd repositoryUpdate knowledge
Preview before Publish · no automatic provider reads
FRESHNESS WARNSuser requests updateNO AUTO DELETEabsence ≠ evidenceNO COMPLETENESS CLAIM
AGENTBASE / REFRESH & RECOVERY12
“Repo mới thì Add repository; repo đã có thì Update knowledge. Bạn không cần chọn thuật ngữ kỹ thuật: cập nhật source dùng Delta; yêu cầu bổ sung kiến thức thiếu dùng Coverage có giới hạn, kể cả source không đổi. Phần chưa kiểm tra được giữ lại để lần sau tiếp tục. Không tự đọc cloud hay Publish. Ba lượt chỉ là giới hạn chi phí, không chứng minh đã đủ kiến thức; cũng không tự chạy ba lượt.”
POSITIONING · WHAT AGENTBASE ADDS13 / 24
NOT A BINARY CHOICE
AgentBase thêm một
knowledge lifecycle.
Không tuyên bố Markdown hay RAG là sai — chúng giải quyết những lớp khác.
PLAIN MARKDOWNDurable documentsCon người đọc và chỉnh sửa tốt.
Schema, provenance và lifecycle cần xây thêm.
RAGRelevant retrievalTìm source chunks phù hợp lúc hỏi.
Reviewed synthesis và authority cần xây thêm.
AGENTBASEGoverned knowledgeSource-backed · reviewable · compounding.
Không thay thế mọi search/RAG use case.
POSITIONMột lifecycle cho shared knowledge — không phải replacement cho mọi search hoặc RAG.
AGENTBASE / POSITIONING13
“Markdown là substrate tốt và AgentBase vẫn dùng nó. RAG rất tốt khi cần retrieve source chunk ở thời điểm hỏi. AgentBase tập trung vào lớp khác: synthesis bền, provenance có cấu trúc, human publication authority và refresh. Ba cách có thể đứng cạnh nhau; AgentBase không cần thay mọi search hay RAG use case.”
RELEASE BOUNDARY · NOW WHAT14 / 24
READY TO LEARN FROM REAL USE
Internal release.
Bounded pilot.
READY NOWCore lifecycle- Add repository
- Update knowledge · Query
- Confirm Publish · Direct/PR
- Linux x64 release path
NOT CLAIMEDNo false certainty- perfect completeness
- generalized ROI / scale
- public hostile security
- every workflow benefits
PILOT ASKOne real Domain- named owners
- bounded repositories
- review real changes
- measure usefulness
LEARNreview effort · escaped semantic defects · context reuse · unresolved questions
AGENTBASE / INTERNAL RELEASE14
“Release hiện tại đủ để pilot nội bộ trên Linux x64 trong môi trường enterprise đã thống nhất. Nó không tuyên bố knowledge hoàn hảo, ROI đã được benchmark rộng, scale không giới hạn hoặc public security hardening. Bước tiếp theo nên là một Domain có owner thật, phạm vi bounded và review các thay đổi thật; kết quả sẽ cho biết review effort, semantic defect và context reuse có đáng tiếp tục hay không.”
AGENTBASE
Context agents can explain.
Knowledge teams can correct.
01SOURCE-BACKEDbiết từ đâu
02REVIEWABLEcon người sửa được
03COMPOUNDINGtốt dần theo thời gian
“AgentBase không cố làm AI nhớ toàn bộ hệ thống và không tạo một knowledge base hoàn hảo trong lần đầu. Nó giữ evidence đủ gần để agent giải thích, giữ human review ở publication boundary để team sửa, và dùng Update knowledge để cập nhật thay đổi hoặc bổ sung phần thiếu. Agent không cần biết mọi thứ; nó cần tìm đúng context mà team có thể kiểm tra và tiếp tục cải thiện. Từ đây mình dừng main talk và nhận câu hỏi; phần sau là technical appendix nếu mọi người muốn đi sâu.”
OPTIONAL TECHNICAL DEEP DIVE · ~7 MINUTES
How AgentBase keeps
knowledge reviewable.
TAKEAWAY NẾU DỪNG Ở ĐÂYAgent reasons·MCP validates boundaries·Humans publish
AGENTBASE / OPTIONAL APPENDIX16
“Main story đã kết thúc. Tám slide tiếp theo đi sâu vào pipeline và runtime cho engineer hoặc Q&A. Nếu không cần theo phần này, takeaway duy nhất là reasoning, validation boundary và publication authority thuộc ba chủ thể khác nhau.”
PIPELINE OVERVIEW17 / 24
FIVE STAGES · ONE REVIEWABLE RESULT
Từ source đến knowledge
có thể review.
01PreflightĐúng repo
và revision
→
02DiscoverChọn điều
đáng giữ
→
03InvestigateKiểm chứng
bằng source
→
04AuthorViết
knowledge
→
05ValidateKiểm tra
contract
SAU 5 BƯỚCFinalize · Inspect → Confirm Publish → Direct hoặc PR
AGENTBASE / INITIAL INGEST OVERVIEW17
“Trước khi đi vào từng bước, đây là toàn bộ quy trình. Preflight khóa đúng repo và revision. Discover chọn phần đáng giữ. Investigate kiểm chứng bằng source. Author viết knowledge. Validate kiểm tra contract trước khi đưa ra review. Đi hết năm bước vẫn chưa tự publish: sau đó mới Finalize, Inspect và con người quyết định Publish theo policy Direct hoặc PR của Hub.”
HOW I DESIGNED THE PIPELINE18 / 24
STAGE 01
Preflight
Khóa identity, revision và preliminary home scope trước khi đọc code.
VẤN ĐỀAgent có thể hiểu đúng code nhưng gắn nó vào sai context.
Ý TƯỞNG CỦA MÌNH
01REPOSITORY IDENTITYĐúng repositoryorigin · checkout · ownership
02SOURCE REVISIONExact commitevidence cùng một snapshot
03PRELIMINARY HOMEInitial scopegrouped plan confirmed later
OUTPUTAuthorized Source Snapshotidentity + revision + preliminary home scope
01Preflight
02Discover
03Investigate
04Author
05Validate
AGENTBASE / INITIAL INGEST18
“Preflight khóa repository identity, exact revision và preliminary home scope. Đây là nhánh Add cho repo mới: repo đã có chuyển sang Update, giữ home hiện tại; identity mơ hồ phải hỏi lại, không tạo bản trùng. Sau discovery, owner xác nhận một grouped home plan cho default home, exception và Domain participation riêng. Physical home không đồng nghĩa semantic participation; vì vậy workflow không ép mọi repository vào một primary Domain.”
HOW I DESIGNED THE PIPELINE19 / 24
STAGE 02
Discover
Tìm phần đáng trở thành knowledge, không inventory toàn bộ codebase.
VẤN ĐỀCopy mọi source artifact sang Markdown chỉ tạo ra một knowledge base nhiễu và nhanh stale.
Ý TƯỞNG CỦA MÌNH
RAW SIGNALSfunctionseventsqueuesroutesresourcesconfigs
→BOUNDED
DISCOVERY
KNOWLEDGE CANDIDATESConcept · RelationQuestion · Ignore(reason)
OUTPUTBounded candidate setsparse by design · Question/Ignore được phép
01Preflight
02Discover
03Investigate
04Author
05Validate
AGENTBASE / INITIAL INGEST19
“Nếu mọi function hoặc Terraform resource đều thành document, Hub chỉ là một bản copy nhanh stale của source. Discover chọn một tập candidate bounded có giá trị để hỏi, giải thích hoặc liên kết. Signal chưa rõ thành Question; phần không đáng lưu được ignore với lý do.”
HOW I DESIGNED THE PIPELINE20 / 24
STAGE 03
Investigate
Dùng Code Graph để tìm đường, dùng exact source để kiểm chứng.
VẤN ĐỀCandidate chỉ là một giả thuyết; agent không được biến suy đoán thành fact.
Ý TƯỞNG CỦA MÌNH
INPUTCandidategiả thuyết
→
NAVIGATECode Graphsymbols · callers · paths
→
VERIFYExact Sourcepath · revision · lines
→
OUTPUTEvidencenormalized · bounded
BOUNDARYRaw graph stays localchỉ normalized evidence đi tiếp
01Preflight
02Discover
03Investigate
04Author
05Validate
AGENTBASE / INITIAL INGEST20
“Graph giúp agent tìm symbol, caller và dependency path mà không scan mù. Nhưng graph không phải canonical knowledge. Kết luận phải quay về exact source trong snapshot đã khóa. Chỉ evidence bounded có provenance mới được đi tiếp; raw graph ở local và có thể rebuild.”
HOW I DESIGNED THE PIPELINE21 / 24
STAGE 04
Author
MCP giữ structure; coding agent tập trung viết meaning.
VẤN ĐỀĐể agent tự dựng YAML, ID và relation từ đầu khiến format dễ drift và khó kiểm soát.
Ý TƯỞNG CỦA MÌNH
AGENTBASE-MCPGenerated OKF skeletonpaths · IDs · frontmatter
sources · relations · navigation
STRUCTURE CONTRACT
+
CODING AGENTEnriched meaningpurpose · architecture
behavior · limitations
REASONING + WRITING
OUTPUTEditable Markdown proposalcon người đọc và sửa trực tiếp
01Preflight
02Discover
03Investigate
04Author
05Validate
AGENTBASE / INITIAL INGEST21
“Nếu agent tự tạo path, YAML, ID và relation từ đầu, format dễ drift. MCP tạo workspace và skeleton theo contract; agent tập trung vào nội dung dựa trên evidence. Ở bước này workspace vẫn sửa được và chưa có publication authority.”
HOW I DESIGNED THE PIPELINE22 / 24
STAGE 05
Validate
MCP kiểm tra deterministically trước khi gọi output là proposal.
VẤN ĐỀAgent không thể tự chứng nhận citation, relation và schema do chính nó vừa viết.
Ý TƯỞNG CỦA MÌNH
01CITATIONSrepo · revision
path · line span
02RELATIONSendpoints
evidence · type
03SCHEMAOKF type
frontmatter · nav
04LIMITSprotected bytes
size · sensitive data
PASSFinalized inspectionvalid ≠ complete
FAILRepairable workspace
01Preflight
02Discover
03Investigate
04Author
05Validate
AGENTBASE / INITIAL INGEST22
“MCP kiểm tra citation, relation, schema và limits một cách deterministic. Failure quay lại workspace với lỗi cụ thể. Pass chỉ có nghĩa output đủ điều kiện để inspect và review; completeness, semantic judgment và business acceptance vẫn không được suy ra từ validation.”
AFTER THE FIVE STAGES23 / 24
HUMAN AUTHORITY
Sau Validate,
con người quyết định.
EDITABLEValidated
WorkspaceFinalize · Inspect
→
HUMAN CONFIRMATIONConfirm
Publishexact reviewed result
→
HUB POLICYDirect
or PRone complete change
→
QUERY AUTHORITYPublished
OKFDirect recognition · or PR sync
HUMANPreview · confirm PublishMCP LIMITNever approve or merge
AGENTBASE / REVIEW & PUBLICATION23
“Finalize khóa bytes và digest để inspect chính xác. Người dùng xem thay đổi quan trọng rồi xác nhận Publish. Direct đẩy commit hoàn chỉnh và ghi nhận nó cho query; PR tạo pull request, chờ team merge rồi sync. Nếu remote đã nhận nhưng local chưa ghi nhận được, báo rõ và recovery, không nói publish thất bại hoàn toàn. MCP không tự approve hay merge PR, không tự chuyển policy khi bị từ chối. Workspace đang soạn vẫn riêng tư, không xuất hiện trong ordinary query.”
RUNTIME ARCHITECTURE24 / 24
SEPARATE REASONING FROM AUTHORITY
Agent reasoning.
MCP giữ boundary.
AI AGENT + SKILLSreason · investigate · synthesize · authorNO MODEL SDK / KEY INSIDE MCP
↓ MCP · stdio / Streamable HTTP
BUSINESS TOOLS + WORKFLOW ORCHESTRATIONfive-stage authoring · refresh · query · review/publishscope · scaffold · validate · transition
↓
CORE CONTRACTScode intelligence · knowledge · hub · queryprovider-neutral
↓ ADAPTERS
Codebase MemoryLocal Git / HubGitHubProvider observations
PRIVATE BOUNDARYsource: read-only authority · raw graph: rebuildable
SHARED BOUNDARYreviewed Git-backed Published Hub
AGENTBASE / MCP ARCHITECTURE24
“Coding agent sở hữu reasoning và synthesis. Skills hướng dẫn workflow. MCP giữ input/output contract, validation, digest và state transition. Adapter mới chạm Codebase Memory, Git, Hub hoặc provider observation. Source là read-only authority; raw graph local và rebuildable; Published Hub là shared reviewed knowledge. AgentBase-MCP không chứa model SDK hoặc model key.”