mirror of
https://github.com/shareAI-lab/analysis_claude_code.git
synced 2026-09-20 12:13:38 +08:00
feat: refresh course through workflow and goal loops
This commit is contained in:
Haoran
@@ -26,6 +26,8 @@ import s17Annotations from "@/data/annotations/s17.json";
|
||||
import s18Annotations from "@/data/annotations/s18.json";
|
||||
import s19Annotations from "@/data/annotations/s19.json";
|
||||
import s20Annotations from "@/data/annotations/s20.json";
|
||||
import s21Annotations from "@/data/annotations/s21.json";
|
||||
import s22Annotations from "@/data/annotations/s22.json";
|
||||
|
||||
interface Decision {
|
||||
id: string;
|
||||
@@ -62,6 +64,8 @@ const ANNOTATIONS: Record<string, AnnotationFile> = {
|
||||
s18: s18Annotations as AnnotationFile,
|
||||
s19: s19Annotations as AnnotationFile,
|
||||
s20: s20Annotations as AnnotationFile,
|
||||
s21: s21Annotations as AnnotationFile,
|
||||
s22: s22Annotations as AnnotationFile,
|
||||
};
|
||||
|
||||
interface DesignDecisionsProps {
|
||||
|
||||
@@ -29,6 +29,8 @@ const scenarioModules: Record<string, () => Promise<{ default: Scenario }>> = {
|
||||
s18: () => import("@/data/scenarios/s18.json") as Promise<{ default: Scenario }>,
|
||||
s19: () => import("@/data/scenarios/s19.json") as Promise<{ default: Scenario }>,
|
||||
s20: () => import("@/data/scenarios/s20.json") as Promise<{ default: Scenario }>,
|
||||
s21: () => import("@/data/scenarios/s21.json") as Promise<{ default: Scenario }>,
|
||||
s22: () => import("@/data/scenarios/s22.json") as Promise<{ default: Scenario }>,
|
||||
};
|
||||
|
||||
interface AgentLoopSimulatorProps {
|
||||
|
||||
@@ -34,7 +34,7 @@ const MEMORY_FILES: MemoryFile[] = [
|
||||
title: "LCC web paths",
|
||||
filename: "lcc_web_paths.md",
|
||||
description: "Web app reads root lesson folders and generated JSON.",
|
||||
body: "Build from web/, extract content from s01-s20 lesson directories.",
|
||||
body: "Build from web/, extract content from the root lesson directories.",
|
||||
},
|
||||
{
|
||||
id: "test-command",
|
||||
|
||||
@@ -3,16 +3,16 @@
|
||||
"decisions": [
|
||||
{
|
||||
"id": "prompt-from-state",
|
||||
"title": "The System Prompt Is Built from Runtime State",
|
||||
"description": "Prompt sections are selected from real state: workspace, available tools, memory, and skills. The prompt becomes a product of the runtime rather than a single hardcoded string.",
|
||||
"title": "Model Input Is Built from Runtime State",
|
||||
"description": "Stable prompt sections and dynamic state are assembled at the model boundary: workspace, available tools, memory, and skills. Model input becomes a product of the runtime rather than a single hardcoded string.",
|
||||
"alternatives": "A static prompt is easier to inspect, but it goes stale as capabilities change.",
|
||||
"zh": {
|
||||
"title": "系统提示词由运行时状态构建",
|
||||
"description": "Prompt section 来自真实状态：workspace、可用工具、memory 和 skills。提示词是运行时的产物，而不是单个硬编码字符串。"
|
||||
"title": "模型输入由运行时状态构建",
|
||||
"description": "稳定 prompt section 与动态状态在模型边界组装：workspace、可用工具、memory 和 skills。模型输入是运行时的产物，而不是单个硬编码字符串。"
|
||||
},
|
||||
"ja": {
|
||||
"title": "システムプロンプトはランタイム状態から作る",
|
||||
"description": "workspace、利用可能ツール、memory、skills などの実状態から prompt section を選びます。プロンプトは単一の固定文字列ではなくランタイムの産物です。"
|
||||
"title": "モデル入力はランタイム状態から作る",
|
||||
"description": "安定した prompt section と workspace、利用可能ツール、memory、skills などの動的状態をモデル境界で組み立てます。モデル入力は単一の固定文字列ではなくランタイムの産物です。"
|
||||
}
|
||||
},
|
||||
{
|
||||
|
||||
@@ -31,16 +31,16 @@
|
||||
},
|
||||
{
|
||||
"id": "identity-reinjection",
|
||||
"title": "Identity Is Re-injected on Each Autonomous Turn",
|
||||
"description": "Autonomous agents need a stable sense of who they are and what they are allowed to do. Re-injecting identity keeps a teammate from drifting into the lead's responsibilities.",
|
||||
"alternatives": "A one-time identity prompt is shorter, but long-running loops are prone to context drift.",
|
||||
"title": "Advanced Teaching Workaround: Identity Re-injection",
|
||||
"description": "The simplified lesson re-injects identity after its compaction heuristic. This is optional teaching scaffolding; production compaction should preserve stable system instructions instead.",
|
||||
"alternatives": "Keep identity in stable system instructions and preserve that boundary through compaction.",
|
||||
"zh": {
|
||||
"title": "每个自治回合都重新注入身份",
|
||||
"description": "自治 agent 需要稳定知道自己是谁、允许做什么。重新注入身份可以防止队友逐渐漂移到 lead 的职责上。"
|
||||
"title": "进阶教学补丁：身份重注入",
|
||||
"description": "简化课程在压缩启发式触发后重新注入身份。这是选学脚手架；生产实现应在压缩时保留稳定的 system 指令。"
|
||||
},
|
||||
"ja": {
|
||||
"title": "各自律ターンでアイデンティティを再注入する",
|
||||
"description": "自律エージェントには、自分が誰で何を許可されているかという安定した認識が必要です。アイデンティティを再注入することで、チームメイトがリードの責務へ漂うことを防ぎます。"
|
||||
"title": "発展用の教育補助：アイデンティティ再注入",
|
||||
"description": "簡略化した教材は圧縮ヒューリスティック後にアイデンティティを再注入します。これは任意の足場であり、本番実装では圧縮を越えて安定した system 指示を保持すべきです。"
|
||||
}
|
||||
}
|
||||
]
|
||||
|
||||
47
web/src/data/annotations/s21.json
Normal file
47
web/src/data/annotations/s21.json
Normal file
@@ -0,0 +1,47 @@
|
||||
{
|
||||
"version": "s21",
|
||||
"decisions": [
|
||||
{
|
||||
"id": "script-owns-fixed-orchestration",
|
||||
"title": "Code Owns Fixed Orchestration",
|
||||
"description": "When the stages and aggregation rules are known in advance, a workflow script makes the process parallel, reproducible, and inspectable without changing the main agent loop.",
|
||||
"alternatives": "Letting the model choose every next step is more flexible, but slower and harder to resume for a fixed procedure.",
|
||||
"zh": {
|
||||
"title": "固定编排由代码负责",
|
||||
"description": "当阶段与汇总规则事先确定时，workflow 脚本能让流程并行、可复现、可检查，同时不修改主 Agent 循环。"
|
||||
},
|
||||
"ja": {
|
||||
"title": "固定された編成はコードが担う",
|
||||
"description": "段階と集約ルールが事前に決まっているなら、workflow script は main Agent loop を変えずに処理を並列化し、再現可能で検査可能にする。"
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "semantic-journal-keys",
|
||||
"title": "Semantic Keys Make Resume Independent of Completion Order",
|
||||
"description": "Journal entries use stable call content rather than a shared completion counter. Concurrent calls can finish in any order and still map to the correct cached result.",
|
||||
"alternatives": "Indexing by completion order is simpler, but replays the wrong result as soon as concurrent timing changes.",
|
||||
"zh": {
|
||||
"title": "语义键让恢复不依赖完成顺序",
|
||||
"description": "Journal 用稳定的调用内容作为 key，而不是共享完成计数器。并发调用无论以什么顺序结束，都能命中正确缓存。"
|
||||
},
|
||||
"ja": {
|
||||
"title": "意味キーで完了順序に依存せず再開する",
|
||||
"description": "Journal は共有完了カウンタではなく安定した call 内容を key にする。並行 call の終了順が変わっても正しい cache result に対応できる。"
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "fail-the-workflow",
|
||||
"title": "Orchestration Failures Propagate",
|
||||
"description": "A failed stage, invalid structured result, corrupt journal, or exceeded run-wide limit fails the workflow instead of silently dropping an item and reporting success.",
|
||||
"alternatives": "Best-effort collection can be useful for optional work, but it must be explicit rather than the default.",
|
||||
"zh": {
|
||||
"title": "编排故障必须向上传播",
|
||||
"description": "阶段失败、结构化结果不合法、journal 损坏或超过全局限制时，workflow 直接失败，而不是静默丢项后仍报告成功。"
|
||||
},
|
||||
"ja": {
|
||||
"title": "編成の失敗は上位へ伝播させる",
|
||||
"description": "stage failure、無効な structured result、破損 journal、run-wide limit 超過は workflow を失敗させ、項目を黙って落として成功扱いしない。"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
47
web/src/data/annotations/s22.json
Normal file
47
web/src/data/annotations/s22.json
Normal file
@@ -0,0 +1,47 @@
|
||||
{
|
||||
"version": "s22",
|
||||
"decisions": [
|
||||
{
|
||||
"id": "host-owns-completion-gate",
|
||||
"title": "The Host Owns the Completion Gate",
|
||||
"description": "The working model may request to stop, but the harness evaluates the active goal before returning. Completion is a program decision at the turn boundary.",
|
||||
"alternatives": "Asking the working model whether it is finished is simpler, but lets the same actor make and verify its own claim.",
|
||||
"zh": {
|
||||
"title": "完成闸门由宿主持有",
|
||||
"description": "工作模型可以请求停止，但 harness 会在 return 前评估 active goal。是否完成是轮次边界上的程序决策。"
|
||||
},
|
||||
"ja": {
|
||||
"title": "完了ゲートはホストが所有する",
|
||||
"description": "作業モデルは停止を要求できるが、harness は return 前に active goal を評価する。完了は turn 境界でのプログラム判断である。"
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "host-assigned-evidence-origins",
|
||||
"title": "Evidence Trust Comes from the Ingress Path",
|
||||
"description": "Ordinary submit calls cannot attach trusted labels. Only an allowlisted host-event channel can deliver task or monitor evidence, so user and model prose cannot certify itself.",
|
||||
"alternatives": "Trusting text content or caller-supplied labels makes the evidence boundary forgeable.",
|
||||
"zh": {
|
||||
"title": "证据信任来自入口路径",
|
||||
"description": "普通 submit 不能附加可信标签；只有白名单宿主事件通道能送入 task 或 monitor 证据，因此用户与模型文本不能自证完成。"
|
||||
},
|
||||
"ja": {
|
||||
"title": "証拠の信頼は入力経路から得る",
|
||||
"description": "通常の submit は trusted label を付けられず、allowlist 済み host event channel だけが task や monitor evidence を届ける。ユーザーやモデルの文章は自己証明できない。"
|
||||
}
|
||||
},
|
||||
{
|
||||
"id": "bounded-continuation",
|
||||
"title": "Every Automatic Continuation Needs a Budget",
|
||||
"description": "An unmet goal queues another turn only while budget remains. Exhaustion marks the goal blocked and releases the gate instead of creating an infinite loop.",
|
||||
"alternatives": "An unbounded goal is persistent, but an impossible condition can consume resources forever.",
|
||||
"zh": {
|
||||
"title": "每次自动续轮都必须有预算",
|
||||
"description": "目标未满足时只在预算剩余时继续；耗尽后将目标标记为 blocked 并释放闸门，避免无限循环。"
|
||||
},
|
||||
"ja": {
|
||||
"title": "自動継続には必ず予算を置く",
|
||||
"description": "goal 未達時は予算が残る間だけ次の turn を追加する。使い切れば blocked にして gate を解放し、無限 loop を防ぐ。"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -541,6 +541,56 @@ export const EXECUTION_FLOWS: Record<string, FlowDefinition> = {
|
||||
{ from: "recover", to: "context" },
|
||||
],
|
||||
},
|
||||
s21: {
|
||||
nodes: [
|
||||
{ id: "start", label: "Workflow Tool Call", type: "start", x: COL_CENTER, y: 30 },
|
||||
{ id: "validate", label: "Validate Meta +\nPermission", type: "process", x: COL_CENTER, y: 120 },
|
||||
{ id: "launch", label: "async_launched", type: "process", x: COL_CENTER, y: 210 },
|
||||
{ id: "phase", label: "Select Phase", type: "process", x: COL_CENTER, y: 300 },
|
||||
{ id: "pipeline", label: "Pipeline /\nParallel Agents", type: "subprocess", x: COL_LEFT, y: 410 },
|
||||
{ id: "journal", label: "Append Journal", type: "process", x: COL_LEFT, y: 520 },
|
||||
{ id: "more", label: "More Stages?", type: "decision", x: COL_CENTER, y: 620 },
|
||||
{ id: "output", label: "Write Output", type: "process", x: COL_RIGHT, y: 520 },
|
||||
{ id: "notify", label: "task_notification", type: "end", x: COL_RIGHT, y: 620 },
|
||||
],
|
||||
edges: [
|
||||
{ from: "start", to: "validate" },
|
||||
{ from: "validate", to: "launch" },
|
||||
{ from: "launch", to: "phase" },
|
||||
{ from: "phase", to: "pipeline" },
|
||||
{ from: "pipeline", to: "journal" },
|
||||
{ from: "journal", to: "more" },
|
||||
{ from: "more", to: "phase", label: "yes" },
|
||||
{ from: "more", to: "output", label: "no" },
|
||||
{ from: "output", to: "notify" },
|
||||
],
|
||||
},
|
||||
s22: {
|
||||
nodes: [
|
||||
{ id: "start", label: "Model Wants to Stop", type: "start", x: COL_CENTER, y: 30 },
|
||||
{ id: "active", label: "Active Goal?", type: "decision", x: COL_CENTER, y: 120 },
|
||||
{ id: "evidence", label: "Read Trusted\nEvidence Window", type: "process", x: COL_CENTER, y: 220 },
|
||||
{ id: "evaluate", label: "Goal Satisfied?", type: "decision", x: COL_CENTER, y: 320 },
|
||||
{ id: "complete", label: "goal_completed", type: "end", x: COL_RIGHT, y: 430 },
|
||||
{ id: "budget", label: "Budget Left?", type: "decision", x: COL_LEFT, y: 430 },
|
||||
{ id: "continue", label: "Queue Goal\nContinuation", type: "process", x: COL_LEFT, y: 540 },
|
||||
{ id: "loop", label: "Next Agent Turn", type: "subprocess", x: COL_LEFT, y: 650 },
|
||||
{ id: "blocked", label: "goal_blocked", type: "end", x: COL_CENTER, y: 540 },
|
||||
{ id: "return", label: "Return", type: "end", x: COL_RIGHT, y: 120 },
|
||||
],
|
||||
edges: [
|
||||
{ from: "start", to: "active" },
|
||||
{ from: "active", to: "return", label: "no" },
|
||||
{ from: "active", to: "evidence", label: "yes" },
|
||||
{ from: "evidence", to: "evaluate" },
|
||||
{ from: "evaluate", to: "complete", label: "yes" },
|
||||
{ from: "evaluate", to: "budget", label: "no" },
|
||||
{ from: "budget", to: "continue", label: "yes" },
|
||||
{ from: "budget", to: "blocked", label: "no" },
|
||||
{ from: "continue", to: "loop" },
|
||||
{ from: "loop", to: "start" },
|
||||
],
|
||||
},
|
||||
};
|
||||
|
||||
const CURRENT_FLOW_OVERRIDES: Record<string, FlowDefinition> = {
|
||||
|
||||
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"version": "s10",
|
||||
"title": "System Prompt",
|
||||
"description": "The system prompt is assembled from runtime state and cached by a deterministic context key.",
|
||||
"title": "Context Assembly",
|
||||
"description": "Stable instructions and dynamic runtime state are assembled at the model boundary and cached by a deterministic context key.",
|
||||
"steps": [
|
||||
{
|
||||
"type": "system_event",
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"version": "s15",
|
||||
"title": "Agent Teams",
|
||||
"description": "A lead agent can spawn teammate loops and coordinate through file-backed mailboxes.",
|
||||
"title": "Agent Teams: Runtime Lab",
|
||||
"description": "The first Agent Teams lab builds persistent teammate loops and file-backed mailboxes.",
|
||||
"steps": [
|
||||
{
|
||||
"type": "user_message",
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"version": "s16",
|
||||
"title": "Team Protocols",
|
||||
"description": "Typed requests, request ids, and response matching turn team chat into a protocol.",
|
||||
"title": "Agent Teams: Protocol Lab",
|
||||
"description": "The second Agent Teams lab adds typed requests, request ids, and response matching to the s15 runtime.",
|
||||
"steps": [
|
||||
{
|
||||
"type": "user_message",
|
||||
|
||||
43
web/src/data/scenarios/s21.json
Normal file
43
web/src/data/scenarios/s21.json
Normal file
@@ -0,0 +1,43 @@
|
||||
{
|
||||
"version": "s21",
|
||||
"title": "Workflow Runtime",
|
||||
"description": "A fixed review pipeline runs in parallel, records a journal, and resumes completed agent calls from cache.",
|
||||
"steps": [
|
||||
{
|
||||
"type": "user_message",
|
||||
"content": "Review this change across correctness, security, performance, and style.",
|
||||
"annotation": "The goal is open-ended, but the review procedure has a fixed shape."
|
||||
},
|
||||
{
|
||||
"type": "tool_call",
|
||||
"toolName": "Workflow",
|
||||
"content": "{\"name\":\"review-changes\",\"phases\":[\"Review\",\"Verify\"]}",
|
||||
"annotation": "One tool call hands deterministic orchestration to the workflow runtime."
|
||||
},
|
||||
{
|
||||
"type": "tool_result",
|
||||
"content": "{\"status\":\"async_launched\",\"runId\":\"wf_review-changes_6779\"}",
|
||||
"annotation": "The product runtime returns a claim ticket while work continues in the background."
|
||||
},
|
||||
{
|
||||
"type": "system_event",
|
||||
"content": "phase=Review -> pipeline([correctness, security, performance, style])",
|
||||
"annotation": "Each item advances independently through the scripted stages."
|
||||
},
|
||||
{
|
||||
"type": "system_event",
|
||||
"content": "phase=Verify -> adversarial checks run in parallel",
|
||||
"annotation": "Structured results cross a validation boundary before aggregation."
|
||||
},
|
||||
{
|
||||
"type": "system_event",
|
||||
"content": "journal append -> task_notification(status=completed)",
|
||||
"annotation": "Every completed agent call is checkpointed before the final notification."
|
||||
},
|
||||
{
|
||||
"type": "system_event",
|
||||
"content": "resumeFromRunId -> unchanged calls status=cached",
|
||||
"annotation": "Semantic keys reuse completed work without depending on concurrency order."
|
||||
}
|
||||
]
|
||||
}
|
||||
37
web/src/data/scenarios/s22.json
Normal file
37
web/src/data/scenarios/s22.json
Normal file
@@ -0,0 +1,37 @@
|
||||
{
|
||||
"version": "s22",
|
||||
"title": "Goal Loop",
|
||||
"description": "A host-owned completion gate keeps the turn alive until trusted evidence satisfies the active goal.",
|
||||
"steps": [
|
||||
{
|
||||
"type": "user_message",
|
||||
"content": "/goal until tests passed and deploy green",
|
||||
"annotation": "The command defines the condition but sits outside the evidence window."
|
||||
},
|
||||
{
|
||||
"type": "system_event",
|
||||
"content": "goal_started -> evidence window reset",
|
||||
"annotation": "The harness, not the working model, owns the completion gate."
|
||||
},
|
||||
{
|
||||
"type": "assistant_text",
|
||||
"content": "Tests passed and deployment is green.",
|
||||
"annotation": "Assistant prose is not trusted completion evidence."
|
||||
},
|
||||
{
|
||||
"type": "system_event",
|
||||
"content": "goal_evaluated satisfied=false -> continuation queued",
|
||||
"annotation": "An unmet condition pushes the loop into another bounded turn."
|
||||
},
|
||||
{
|
||||
"type": "tool_result",
|
||||
"content": "<task_notification>tests passed; deploy green</task_notification>",
|
||||
"annotation": "Only an allowlisted host event can attach a trusted evidence origin."
|
||||
},
|
||||
{
|
||||
"type": "system_event",
|
||||
"content": "goal_evaluated satisfied=true -> goal_completed",
|
||||
"annotation": "Trusted evidence closes the goal and releases the stop gate."
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -1,10 +1,10 @@
|
||||
{
|
||||
"meta": { "title": "Learn Claude Code", "description": "Build a nano Claude Code-like agent from 0 to 1, one mechanism at a time" },
|
||||
"nav": { "home": "Home", "timeline": "Timeline", "compare": "Compare", "layers": "Layers", "github": "GitHub" },
|
||||
"home": { "hero_title": "Learn Claude Code", "hero_subtitle": "Build a nano Claude Code-like agent from 0 to 1, one mechanism at a time", "start": "Start Learning", "core_pattern": "The Core Pattern", "core_pattern_desc": "Every AI coding agent shares the same loop: call the model, execute tools, feed results back. Production systems add policy, permissions, and lifecycle layers on top.", "learning_path": "Learning Path", "learning_path_desc": "20 progressive sessions, from a simple loop to a complete multi-agent harness", "layers_title": "Architectural Layers", "layers_desc": "Five orthogonal concerns that compose into a complete agent", "loc": "LOC", "learn_more": "Learn More", "versions_in_layer": "versions", "message_flow": "Message Growth", "message_flow_desc": "Watch the messages array grow as the agent loop executes" },
|
||||
"home": { "hero_title": "Learn Claude Code", "hero_subtitle": "Build a nano Claude Code-like agent from 0 to 1, one mechanism at a time", "start": "Start Learning", "core_pattern": "The Core Pattern", "core_pattern_desc": "Every AI coding agent shares the same loop: call the model, execute tools, feed results back. Production systems add policy, permissions, and lifecycle layers on top.", "learning_path": "Learning Path", "learning_path_desc": "22 progressive sessions, from a simple loop to deterministic orchestration and goal closure", "layers_title": "Architectural Layers", "layers_desc": "Five orthogonal concerns that compose into a complete agent", "loc": "LOC", "learn_more": "Learn More", "versions_in_layer": "versions", "message_flow": "Message Growth", "message_flow_desc": "Watch the messages array grow as the agent loop executes" },
|
||||
"version": { "loc": "lines of code", "tools": "tools", "new": "New", "prev": "Previous", "next": "Next", "view_source": "View Source", "view_diff": "View Diff", "design_decisions": "Design Decisions", "whats_new": "What's New", "tutorial": "Tutorial", "simulator": "Agent Loop Simulator", "execution_flow": "Execution Flow", "architecture": "Architecture", "concept_viz": "Concept Visualization", "alternatives": "Alternatives Considered", "tab_learn": "Learn", "tab_simulate": "Simulate", "tab_code": "Code", "tab_deep_dive": "Deep Dive" },
|
||||
"sim": { "play": "Play", "pause": "Pause", "step": "Step", "reset": "Reset", "speed": "Speed", "step_of": "of" },
|
||||
"timeline": { "title": "Learning Path", "subtitle": "s01 to s20: Progressive Agent Harness Design", "layer_legend": "Layer Legend", "loc_growth": "LOC Growth", "learn_more": "Learn More" },
|
||||
"timeline": { "title": "Learning Path", "subtitle": "s01 to s22: Progressive Agent Harness Design", "layer_legend": "Layer Legend", "loc_growth": "LOC Growth", "learn_more": "Learn More" },
|
||||
"layers": {
|
||||
"title": "Architectural Layers",
|
||||
"subtitle": "Five orthogonal concerns that compose into a complete agent",
|
||||
@@ -48,17 +48,19 @@
|
||||
"s07": "Skills",
|
||||
"s08": "Context Compact",
|
||||
"s09": "Memory",
|
||||
"s10": "System Prompt",
|
||||
"s10": "Context Assembly",
|
||||
"s11": "Error Recovery",
|
||||
"s12": "Task System",
|
||||
"s13": "Background Tasks",
|
||||
"s14": "Cron Scheduler",
|
||||
"s15": "Agent Teams",
|
||||
"s16": "Team Protocols",
|
||||
"s15": "Agent Teams: Runtime Lab",
|
||||
"s16": "Agent Teams: Protocol Lab",
|
||||
"s17": "Autonomous Agents",
|
||||
"s18": "Worktree Isolation",
|
||||
"s19": "MCP Tools",
|
||||
"s20": "Comprehensive Agent Turn"
|
||||
"s20": "Comprehensive Agent Turn",
|
||||
"s21": "Workflow Runtime",
|
||||
"s22": "Goal Loop"
|
||||
},
|
||||
"layer_labels": {
|
||||
"tools": "Tools & Execution",
|
||||
@@ -77,16 +79,18 @@
|
||||
"s07": "On-Demand Skill Loading",
|
||||
"s08": "Three-Layer Context Compression",
|
||||
"s09": "Memory Library",
|
||||
"s10": "Runtime Prompt Assembly",
|
||||
"s10": "Runtime Context Assembly",
|
||||
"s11": "Error Recovery Paths",
|
||||
"s12": "Task Board Dependencies",
|
||||
"s13": "Background Task Lanes",
|
||||
"s14": "Cron Scheduler",
|
||||
"s15": "Team Mailbox Workbench",
|
||||
"s16": "Team Protocol Cards",
|
||||
"s15": "Agent Teams Runtime Lab",
|
||||
"s16": "Agent Teams Protocol Lab",
|
||||
"s17": "Autonomous Agent Cycle",
|
||||
"s18": "Worktree Task Isolation",
|
||||
"s19": "MCP Tool Bridge",
|
||||
"s20": "Comprehensive Agent Turn"
|
||||
"s20": "Comprehensive Agent Turn",
|
||||
"s21": "Workflow Runtime",
|
||||
"s22": "Goal Completion Gate"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,10 +1,10 @@
|
||||
{
|
||||
"meta": { "title": "Learn Claude Code", "description": "0 から 1 へ nano Claude Code-like agent を構築し、毎回 1 つの仕組みを追加" },
|
||||
"nav": { "home": "ホーム", "timeline": "学習パス", "compare": "バージョン比較", "layers": "アーキテクチャ層", "github": "GitHub" },
|
||||
"home": { "hero_title": "Learn Claude Code", "hero_subtitle": "0 から 1 へ nano Claude Code-like agent を構築し、毎回 1 つの仕組みを追加", "start": "学習を始める", "core_pattern": "コアパターン", "core_pattern_desc": "すべての AI コーディングエージェントは同じループを共有する：モデルを呼び出し、ツールを実行し、結果を返す。実運用ではこの上にポリシー、権限、ライフサイクル層が重なる。", "learning_path": "学習パス", "learning_path_desc": "20の段階的セッション、シンプルなループから完全なマルチエージェント Harness まで", "layers_title": "アーキテクチャ層", "layers_desc": "5つの直交する関心事が完全なエージェントを構成", "loc": "行", "learn_more": "詳細を見る", "versions_in_layer": "バージョン", "message_flow": "メッセージの増加", "message_flow_desc": "エージェントループ実行時のメッセージ配列の成長を観察" },
|
||||
"home": { "hero_title": "Learn Claude Code", "hero_subtitle": "0 から 1 へ nano Claude Code-like agent を構築し、毎回 1 つの仕組みを追加", "start": "学習を始める", "core_pattern": "コアパターン", "core_pattern_desc": "すべての AI コーディングエージェントは同じループを共有する：モデルを呼び出し、ツールを実行し、結果を返す。実運用ではこの上にポリシー、権限、ライフサイクル層が重なる。", "learning_path": "学習パス", "learning_path_desc": "22の段階的セッション、シンプルなループから決定的な編成と目標完了まで", "layers_title": "アーキテクチャ層", "layers_desc": "5つの直交する関心事が完全なエージェントを構成", "loc": "行", "learn_more": "詳細を見る", "versions_in_layer": "バージョン", "message_flow": "メッセージの増加", "message_flow_desc": "エージェントループ実行時のメッセージ配列の成長を観察" },
|
||||
"version": { "loc": "行のコード", "tools": "ツール", "new": "新規", "prev": "前のバージョン", "next": "次のバージョン", "view_source": "ソースを見る", "view_diff": "差分を見る", "design_decisions": "設計判断", "whats_new": "新機能", "tutorial": "チュートリアル", "simulator": "エージェントループシミュレーター", "execution_flow": "実行フロー", "architecture": "アーキテクチャ", "concept_viz": "コンセプト可視化", "alternatives": "検討された代替案", "tab_learn": "学習", "tab_simulate": "シミュレーション", "tab_code": "ソースコード", "tab_deep_dive": "詳細分析" },
|
||||
"sim": { "play": "再生", "pause": "一時停止", "step": "ステップ", "reset": "リセット", "speed": "速度", "step_of": "/" },
|
||||
"timeline": { "title": "学習パス", "subtitle": "s01からs20へ：段階的エージェント Harness 設計", "layer_legend": "レイヤー凡例", "loc_growth": "コード量の推移", "learn_more": "詳細を見る" },
|
||||
"timeline": { "title": "学習パス", "subtitle": "s01からs22へ：段階的エージェント Harness 設計", "layer_legend": "レイヤー凡例", "loc_growth": "コード量の推移", "learn_more": "詳細を見る" },
|
||||
"layers": {
|
||||
"title": "アーキテクチャ層",
|
||||
"subtitle": "5つの直交する関心事が完全なエージェントを構成",
|
||||
@@ -48,17 +48,19 @@
|
||||
"s07": "スキル",
|
||||
"s08": "コンテキスト圧縮",
|
||||
"s09": "メモリ",
|
||||
"s10": "システムプロンプト",
|
||||
"s10": "コンテキスト組み立て",
|
||||
"s11": "エラー回復",
|
||||
"s12": "タスクシステム",
|
||||
"s13": "バックグラウンドタスク",
|
||||
"s14": "Cron スケジューラー",
|
||||
"s15": "エージェントチーム",
|
||||
"s16": "チームプロトコル",
|
||||
"s15": "Agent Teams：ランタイム実験",
|
||||
"s16": "Agent Teams：プロトコル実験",
|
||||
"s17": "自律エージェント",
|
||||
"s18": "Worktree 分離",
|
||||
"s19": "MCP ツール",
|
||||
"s20": "Comprehensive Agent Turn"
|
||||
"s20": "Comprehensive Agent Turn",
|
||||
"s21": "Workflow Runtime",
|
||||
"s22": "Goal Loop"
|
||||
},
|
||||
"layer_labels": {
|
||||
"tools": "ツールと実行",
|
||||
@@ -77,16 +79,18 @@
|
||||
"s07": "オンデマンド スキルローディング",
|
||||
"s08": "3層コンテキスト圧縮",
|
||||
"s09": "メモリライブラリ",
|
||||
"s10": "実行時プロンプト組み立て",
|
||||
"s10": "実行時コンテキスト組み立て",
|
||||
"s11": "エラー回復経路",
|
||||
"s12": "タスクボード依存関係",
|
||||
"s13": "バックグラウンドタスクレーン",
|
||||
"s14": "Cron スケジューラー",
|
||||
"s15": "チームメールボックス作業台",
|
||||
"s16": "Team Protocol Cards",
|
||||
"s15": "Agent Teams ランタイム実験",
|
||||
"s16": "Agent Teams プロトコル実験",
|
||||
"s17": "自律エージェントサイクル",
|
||||
"s18": "Worktree タスク分離",
|
||||
"s19": "MCP ツールブリッジ",
|
||||
"s20": "Comprehensive Agent Turn"
|
||||
"s20": "Comprehensive Agent Turn",
|
||||
"s21": "Workflow Runtime",
|
||||
"s22": "目標完了ゲート"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,10 +1,10 @@
|
||||
{
|
||||
"meta": { "title": "Learn Claude Code", "description": "从 0 到 1 构建 nano Claude Code-like agent，每次只加一个机制" },
|
||||
"nav": { "home": "首页", "timeline": "学习路径", "compare": "版本对比", "layers": "架构层", "github": "GitHub" },
|
||||
"home": { "hero_title": "Learn Claude Code", "hero_subtitle": "从 0 到 1 构建 nano Claude Code-like agent，每次只加一个机制", "start": "开始学习", "core_pattern": "核心模式", "core_pattern_desc": "所有 AI 编程 Agent 共享同一个循环：调用模型、执行工具、回传结果。生产级系统会在其上叠加策略、权限和生命周期层。", "learning_path": "学习路径", "learning_path_desc": "20 个渐进式课程，从简单循环到完整多 Agent Harness", "layers_title": "架构层次", "layers_desc": "五个正交关注点组合成完整的 Agent", "loc": "行", "learn_more": "了解更多", "versions_in_layer": "个版本", "message_flow": "消息增长", "message_flow_desc": "观察 Agent 循环执行时消息数组的增长" },
|
||||
"home": { "hero_title": "Learn Claude Code", "hero_subtitle": "从 0 到 1 构建 nano Claude Code-like agent，每次只加一个机制", "start": "开始学习", "core_pattern": "核心模式", "core_pattern_desc": "所有 AI 编程 Agent 共享同一个循环：调用模型、执行工具、回传结果。生产级系统会在其上叠加策略、权限和生命周期层。", "learning_path": "学习路径", "learning_path_desc": "22 个渐进式课程，从简单循环到确定性编排与目标闭环", "layers_title": "架构层次", "layers_desc": "五个正交关注点组合成完整的 Agent", "loc": "行", "learn_more": "了解更多", "versions_in_layer": "个版本", "message_flow": "消息增长", "message_flow_desc": "观察 Agent 循环执行时消息数组的增长" },
|
||||
"version": { "loc": "行代码", "tools": "个工具", "new": "新增", "prev": "上一版", "next": "下一版", "view_source": "查看源码", "view_diff": "查看变更", "design_decisions": "设计决策", "whats_new": "新增内容", "tutorial": "教程", "simulator": "Agent 循环模拟器", "execution_flow": "执行流程", "architecture": "架构", "concept_viz": "概念可视化", "alternatives": "替代方案", "tab_learn": "学习", "tab_simulate": "模拟", "tab_code": "源码", "tab_deep_dive": "深入探索" },
|
||||
"sim": { "play": "播放", "pause": "暂停", "step": "单步", "reset": "重置", "speed": "速度", "step_of": "/" },
|
||||
"timeline": { "title": "学习路径", "subtitle": "s01 到 s20：渐进式 Agent Harness 设计", "layer_legend": "层次图例", "loc_growth": "代码量增长", "learn_more": "了解更多" },
|
||||
"timeline": { "title": "学习路径", "subtitle": "s01 到 s22：渐进式 Agent Harness 设计", "layer_legend": "层次图例", "loc_growth": "代码量增长", "learn_more": "了解更多" },
|
||||
"layers": {
|
||||
"title": "架构层次",
|
||||
"subtitle": "五个正交关注点组合成完整的 Agent",
|
||||
@@ -48,17 +48,19 @@
|
||||
"s07": "Skills",
|
||||
"s08": "Context Compact",
|
||||
"s09": "Memory",
|
||||
"s10": "System Prompt",
|
||||
"s10": "Context Assembly",
|
||||
"s11": "Error Recovery",
|
||||
"s12": "Task System",
|
||||
"s13": "Background Tasks",
|
||||
"s14": "Cron Scheduler",
|
||||
"s15": "Agent Teams",
|
||||
"s16": "Team Protocols",
|
||||
"s15": "Agent Teams：运行时实验",
|
||||
"s16": "Agent Teams：协议实验",
|
||||
"s17": "Autonomous Agents",
|
||||
"s18": "Worktree Isolation",
|
||||
"s19": "MCP Tools",
|
||||
"s20": "Comprehensive Agent Turn"
|
||||
"s20": "Comprehensive Agent Turn",
|
||||
"s21": "Workflow Runtime",
|
||||
"s22": "Goal Loop"
|
||||
},
|
||||
"layer_labels": {
|
||||
"tools": "工具与执行",
|
||||
@@ -77,16 +79,18 @@
|
||||
"s07": "On-Demand Skill Loading",
|
||||
"s08": "Three-Layer Context Compact",
|
||||
"s09": "记忆图书馆",
|
||||
"s10": "Runtime Prompt Assembly",
|
||||
"s10": "运行时上下文组装",
|
||||
"s11": "Error Recovery Paths",
|
||||
"s12": "任务看板依赖",
|
||||
"s13": "Background Task Lanes",
|
||||
"s14": "Cron Scheduler",
|
||||
"s15": "团队邮箱工作台",
|
||||
"s16": "Team Protocol Cards",
|
||||
"s15": "Agent Teams 运行时实验",
|
||||
"s16": "Agent Teams 协议实验",
|
||||
"s17": "Autonomous Agent Cycle",
|
||||
"s18": "Worktree Task Isolation",
|
||||
"s19": "MCP Tool Bridge",
|
||||
"s20": "Comprehensive Agent Turn"
|
||||
"s20": "Comprehensive Agent Turn",
|
||||
"s21": "Workflow Runtime",
|
||||
"s22": "目标完成闸门"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -21,6 +21,8 @@ export const VERSION_ORDER = [
|
||||
"s18",
|
||||
"s19",
|
||||
"s20",
|
||||
"s21",
|
||||
"s22",
|
||||
] as const;
|
||||
|
||||
export const LEARNING_PATH = VERSION_ORDER;
|
||||
@@ -108,10 +110,10 @@ export const VERSION_META: Record<string, {
|
||||
prevVersion: "s08",
|
||||
},
|
||||
s10: {
|
||||
title: "System Prompt",
|
||||
subtitle: "Assembled at Runtime, Never Hardcoded",
|
||||
coreAddition: "Runtime prompt assembly",
|
||||
keyInsight: "The system prompt is a generated product of policy, tools, skills, and context.",
|
||||
title: "Context Assembly",
|
||||
subtitle: "Build Model Input from Runtime State",
|
||||
coreAddition: "Runtime context assembly",
|
||||
keyInsight: "Stable instructions and dynamic state should be assembled deliberately at the model boundary.",
|
||||
layer: "planning",
|
||||
prevVersion: "s09",
|
||||
},
|
||||
@@ -148,16 +150,16 @@ export const VERSION_META: Record<string, {
|
||||
prevVersion: "s13",
|
||||
},
|
||||
s15: {
|
||||
title: "Agent Teams",
|
||||
subtitle: "One Agent Isn't Enough, Form a Team",
|
||||
title: "Agent Teams: Runtime Lab",
|
||||
subtitle: "Persistent Teammates and Mailboxes",
|
||||
coreAddition: "Teammate mailboxes",
|
||||
keyInsight: "Persistent teammates let work continue in parallel without stuffing every thought into one context.",
|
||||
layer: "collaboration",
|
||||
prevVersion: "s14",
|
||||
},
|
||||
s16: {
|
||||
title: "Team Protocols",
|
||||
subtitle: "Teammates Need Agreements",
|
||||
title: "Agent Teams: Protocol Lab",
|
||||
subtitle: "Typed Requests, Replies, and Handshakes",
|
||||
coreAddition: "Shared coordination protocols",
|
||||
keyInsight: "Multi-agent systems need explicit message contracts, not vibes.",
|
||||
layer: "collaboration",
|
||||
@@ -195,6 +197,22 @@ export const VERSION_META: Record<string, {
|
||||
layer: "collaboration",
|
||||
prevVersion: "s19",
|
||||
},
|
||||
s21: {
|
||||
title: "Workflow Runtime",
|
||||
subtitle: "Scripts Own Fixed Orchestration",
|
||||
coreAddition: "Resumable workflow runtime",
|
||||
keyInsight: "When orchestration has a fixed shape, code can make it parallel, deterministic, and resumable.",
|
||||
layer: "concurrency",
|
||||
prevVersion: "s20",
|
||||
},
|
||||
s22: {
|
||||
title: "Goal Loop",
|
||||
subtitle: "Trusted Evidence Decides When to Stop",
|
||||
coreAddition: "Goal completion gate",
|
||||
keyInsight: "A durable goal keeps the loop working until trusted evidence satisfies an explicit condition.",
|
||||
layer: "planning",
|
||||
prevVersion: "s21",
|
||||
},
|
||||
};
|
||||
|
||||
export const LAYERS = [
|
||||
@@ -208,7 +226,7 @@ export const LAYERS = [
|
||||
id: "planning" as const,
|
||||
label: "Planning & Control",
|
||||
color: "#10B981",
|
||||
versions: ["s05", "s06", "s07", "s10", "s11"],
|
||||
versions: ["s05", "s06", "s07", "s10", "s11", "s22"],
|
||||
},
|
||||
{
|
||||
id: "memory" as const,
|
||||
@@ -220,7 +238,7 @@ export const LAYERS = [
|
||||
id: "concurrency" as const,
|
||||
label: "Concurrency & Scheduling",
|
||||
color: "#F59E0B",
|
||||
versions: ["s13", "s14"],
|
||||
versions: ["s13", "s14", "s21"],
|
||||
},
|
||||
{
|
||||
id: "collaboration" as const,
|
||||
|
||||
Reference in New Issue
Block a user