motoko (Joshuacook)

汽车

使用Context Lake模式进行个人知识管理。

概述

Motoko是一种文件系统优先的个人知识管理方法：

• 工作区是git repos -每个工作区都是一个自包含的目录，有自己的模式和历史记录
• 实体是markdown文件 -任务、笔记、项目、日记条目存储为 .md 带有YAML frontmatter的文件
• Claude Code作为接口 -直接在文件系统上使用Claude Code来处理实体
• Tachikoma用于维护 -通过决策文件建议清理的批处理作业

所有名字都来自壳牌幽灵队第9分队。

结构

~/working/motoko/
├── README.md              # This file
├── MOTOKO.md              # System overview
├── CONTEXT_LAKE.md        # Architecture documentation
├── BATOU.md               # MCP server specification
├── TACHIKOMA.md           # Maintenance agent specification
├── CLAUDE.md              # System prompt (for Claude Code)
├── ROADMAP.md             # Project roadmap
├── batou/                 # MCP server (structured entity tools)
│   ├── pyproject.toml
│   ├── README.md
│   └── src/batou/
├── tachikoma/             # Maintenance agent CLI
│   ├── pyproject.toml
│   └── src/tachikoma/
└── workspaces/            # Your workspaces
    ├── coyote/            # Music production
    ├── escuela/           # Teaching/education
    ├── personal/          # Personal tasks
    └── project-management/

工作区结构

每个工作区都遵循以下模式：

{workspace}/
├── .mcp.json                    # Batou MCP server config
├── .claude/
│   ├── schema.yaml              # Entity type definitions
│   └── tachikoma-summary.yaml   # Tachikoma's workspace understanding
├── roles/                       # Role definitions
├── docs/                        # Documentation
├── tasks/                       # Task entities
├── projects/                    # Project entities
├── journal/                     # Journal entries (if applicable)
├── decisions/                   # Tachikoma cleanup proposals
└── {other}/                     # Per schema.yaml

用法

与克劳德·科德（Motoko）合作

在Claude Code中打开一个工作区：

cd ~/working/motoko/workspaces/personal
claude

Claude Code可以通过两种方式处理实体：

1. 非结构化 -直接文件操作（读取、写入、全局）。完全灵活。
2. 结构化的 -Batou MCP工具(list_entities, create_entity等等）。模式感知。

设置巴图

安装Batou MCP服务器：

cd ~/working/motoko/batou
uv sync

添加 .mcp.json 到您的工作区根目录：

{
  "mcpServers": {
    "batou": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/motoko/batou", "batou"],
      "env": {
        "WORKSPACE_PATH": "/path/to/workspace"
      }
    }
  }
}

现在，Claude Code既有原始文件访问工具，也有结构化实体工具。

跑步Tachikoma

Tachikoma是基于Claude Agent SDK构建的CLI工具。在工作区上运行清理：

cd ~/working/motoko/tachikoma
uv run tachikoma schema /path/to/workspace
uv run tachikoma frontmatter /path/to/workspace
uv run tachikoma structure /path/to/workspace

审查生成的决策：

ls /path/to/workspace/decisions/

实体类型

每个工作区在中定义自己的实体类型 .claude/schema.yaml常见模式：

任务

---
status: open  # open, in_progress, done, blocked, cancelled
---

项目

---
code: PROJ
name: Project Name
status: Active
---

期刊

---
date: 2024-01-15
---

文档

• MOTOKO.md -系统概述
• CONTEXT_LAKE.md -架构文档
• BATOU.md -MCP服务器规范
• TACHIKOMA.md -维护剂规格
• CLAUDE.md -克劳德代码的系统提示
• ROADMAP.md -项目路线图