# IWE: Intellectual Work Environment Template > MIT-licensed template for an AI-augmented exocortex: ORZ session rituals, knowledge Packs, Strategist planning, and environment-scoped memory. ## Install Copy the content below into your project: # IWE: Intellectual Work Environment Template MIT-licensed template for an AI-augmented exocortex: ORZ session rituals, knowledge Packs, Strategist planning, and environment-scoped memory. # Quick Use IWE (Intellectual Work Environment) is an MIT-licensed repository template from TserenTserenov/FMT-exocortex-template (version 0.41.10) that turns a fork of the repository into a personal environment where AI agents operate with persistent context. The project positions IWE as an IDE for thinking rather than for code: instead of editor/compiler/debugger, it pairs an exocortex (files of plans, context, conclusions) with principles, the ORZ ritual (Open → Work → Close), and an architectural gate. The environment is described as a platform-agnostic layer that runs on top of any AI platform, with documented support for Claude Code, Kimi Code, and Hermes Agent. Source reviewed; runtime not tested. ## Introduction IWE addresses the fragmentation of work context across different tools and AI services. It provides a structured environment to capture knowledge, plan work, and maintain continuity between sessions. Key components include: * **Exocortex**: External memory files containing plans, context, and conclusions. * **ORZ Protocol**: A ritual for every session and day (Open → Work → Close) to prevent context loss. * **Pack**: A formalized knowledge base for specific domains. * **Strategist**: An AI agent for automated daily/weekly planning. ## Prerequisites Per the README, prerequisites include: * Git, Node.js, and (for the full flow) Claude Code. * Minimum 4 GiB free RAM while Claude Code (or another agent) runs on top of IWE. Lower memory can cause tool read/write failures with a `PreToolUse hook did not respond before its timeout` message. * A GitHub account and `gh` CLI for the fork-based quick start. ## Permissions and Limitations * **License**: MIT (Copyright (c) 2026 Tseren Tserenov). Forking and customization are the intended model. * **Data Handling**: Three protection zones are described: local, GitHub (private repos), and platform (per-user isolation). See `docs/DATA-POLICY.md` and `docs/DATA-RESIDENCY.md` for details. * **Platform Support**: macOS and Linux have first-class scenarios. On Windows, only parts are validated via Git Bash with native Python; `session-guard.sh` and session opening require WSL2 due to Unix lock issues. Full installation and updates on Windows remain unverified. * **No Runtime Verification**: This guide has not been executed or tested in a live environment. ## Setup Instructions Quick start (Git, Node.js, Claude Code already installed): ```bash mkdir -p ~/IWE && cd ~/IWE gh repo fork TserenTserenov/FMT-exocortex-template --clone cd FMT-exocortex-template bash setup.sh ``` After setup: ```bash cd ~/IWE claude ``` Then tell Claude: **«Проведём первую стратегическую сессию»** to walk through goal setting, the first plan, and environment configuration. Full installation from a clean computer is documented in `docs/SETUP-GUIDE.md` (30–60 minutes). A minimal `setup.sh --core` variant works with any AI CLI. Readers not on macOS or not using Claude Code should refer to `docs/PORTABILITY.md`. ## Customization IWE is updated as a distribution. Platform updates arrive without losing personal settings. **Extensions (`extensions/`)** add blocks to protocols: ```bash # Добавить рефлексию в конце дня echo "## Рефлексия дня - Что было сложным? - Что бы сделал иначе? - За что похвалить?" > extensions/day-close.after.md ``` **Parameters (`params.yaml`)** toggle protocol steps: ```yaml reflection_enabled: true # Включить рефлексию video_check: false # Отключить проверку видео multiplier_enabled: true # Мультипликатор IWE ``` **Updates**: `bash update.sh` updates the platform while preserving your `extensions/`, `params.yaml`, and edits to `CLAUDE.md` (3-way merge). ## Repository Families The exocortex is not one repository but a set of clearly bounded families: | Family | Stores | Example Name | |---|---|---| | Base (`ZP`/`FPF`/`SPF`/`FMT-*`) | Platform principles and formats — supplied ready-made | `ZP`, `FPF` | | `PACK-*` | Formalized domain knowledge (source-of-truth) | `PACK-my-domain` | | `DS-*` | Code, plans, courses — derived from Pack | `DS-strategy` | | `PD-*` | Personal data of a single type (no code) | `PD-persona`, `PD-metrics` | | `MC-*` | Agent data (dialogues, service logs) — not read by humans day-to-day | `MC-sessions` | ## FAQ **Q: Is an Anthropic subscription required?** A: For the full installation (Claude Code), the README recommends Claude Pro ($20/mo), with a possible move to Claude Max (~$100/mo) for unrestricted work. The minimal `setup.sh --core` path works with any AI CLI. See `docs/SETUP-GUIDE.md`. **Q: Does it work with AI tools other than Claude?** A: Yes, three agents are documented out of the box: Claude Code (full support via `CLAUDE.md`), Kimi Code in VS Code (reads `AGENTS.md` automatically), and Hermes Agent (connect Aisystant MCP). Other agents such as Cursor, Copilot, and Gemini require adaptation. See `docs/PORTABILITY.md`. ## Source and Thanks Source: [TserenTserenov/FMT-exocortex-template](https://github.com/TserenTserenov/FMT-exocortex-template) — README reviewed at commit `415d61a98cd2dc471480b3ad01ece6648d814181`. Licensed under MIT, Copyright (c) 2026 Tseren Tserenov. Thanks to the author and the IWE community for documenting this environment publicly. Source reviewed; runtime not tested. ## Complete upstream material # IWE — Intellectual Work Environment [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) [![Version](https://img.shields.io/badge/version-0.41.10-blue.svg)](CHANGELOG.md) [![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows%20(partial)-lightgrey.svg)]() [![EN sync](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/TserenTserenov/FMT-exocortex-template/en-draft/badge-data.json)](https://github.com/TserenTserenov/FMT-exocortex-template/tree/en-draft) Open, Work, Close — the same cycle at every scale: session, day, week > Operating system for intellectual work. Your knowledge. Your experience. Your environment — runs on top of any AI platform. > > **Repository type:** `Base/Formats` (FMT) — a template distribution. After forking, it becomes your personal environment with AI agents. --- ## The Problem AI assistants can generate text, code, and answers. But most users face the same issues: - **Work context is scattered.** AI services can store conversations and project materials, but decisions and plans from other tools are not always available in the next session or to another agent. - **Knowledge stays in your head.** You took a course, read a book, solved a problem — but a month later, you cannot reproduce your train of thought. - **AI replaces thinking rather than enhancing it.** You get an answer, but you do not become more competent. Without AI, you are back to zero. - **No system.** Plans are in notes, tasks are in your head, knowledge is in chats. Everything is disjointed. - **Time slips away.** It is unclear what you worked on, what you did, and where you are heading. --- ## Solution: An IDE, but for Thinking **IWE (Intellectual Work Environment)** — an intellectual working environment. Just as an IDE combines an editor, compiler, and debugger into a single environment for a programmer, IWE combines knowledge, planning, and AI agents into a single environment for thinking. | IDE (for code) | IWE (for thinking) | |---------------|-------------------| | Editor → write code | Exocortex → capture knowledge | | Compiler → check syntax | Principles → verify decision correctness | | Debugger → find errors | ORZ Protocols (Open→Work→Close) → identify losses of knowledge and context | | Linter → improve quality | ArchGate → evaluate architectural decisions | | Git → change history | Strategist → work history and planning | > **Key principle: exoskeleton, not prosthetic.** IWE enhances your thinking rather than replacing it. After each session, you become more competent, not just receiving a result. Details: [principles-vs-skills.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/principles-vs-skills.md). ## Key IWE Terms | Term | What it is | |--------|---------| | **Exocortex** | Your external memory — files with plans, context, and conclusions that Claude reads in every session | | **Pack** | A formalized knowledge base for your domain — the single source-of-truth for domain knowledge | | **ORZ** | Open → Work → Close — a ritual for every session and every day, preventing context loss | | **ArchGate** | Structured evaluation of architectural decisions by 7 characteristics (instead of "it seems good to me") | | **Strategist** | An AI agent that automatically creates daily/weekly plans and tracks progress | | **5 repository families** | Recommended structure for separating code, knowledge, and data — see below | Full glossary: [ONTOLOGY.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/ONTOLOGY.md) ### 5 Repository Families The exocortex is not a single repository but a set with clear boundaries: code, domain knowledge, and personal data are not mixed. `setup.sh` creates a minimal start (your strategic repository + 3 base principle repositories); the rest is created as needed. | Family | What it stores | Example name | |---|---|---| | Base (`ZP`/`FPF`/`SPF`/`FMT-*`) | Platform principles and formats — supplied ready-made | `ZP`, `FPF` | | `PACK-*` | Formalized domain knowledge (source-of-truth) | `PACK-my-domain` | | `DS-*` | Code, plans, courses — derived from Pack | `DS-strategy` | | `PD-*` | Personal user data of one type (no code) | `PD-persona`, `PD-metrics` | | `MC-*` | Agent data (dialogues, service logs) — not read by humans day-to-day | `MC-sessions` | Detailed data domain map and justification: [ADR-004](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/adr/ADR-004-data-domain-map.md). --- ## Work Culture — A New Style of Interaction with AI IWE is not a set of prompts. It is a **work culture**: 14 elements (protocols, skills, formats) that transform chaotic interaction with AI into a managed process. Details: [DP.M.008 — IWE Operating Rules](https://github.com/TserenTserenov/PACK-digital-platform/blob/main/pack/digital-platform/03-methods/DP.M.008-iwe-operating-rules.md). ### ORZ Protocol (Open → Work → Close) Each session and each day goes through three stages: - **Open** — Claude checks the plan, defines the task, and agrees on the approach. You do not start work "from scratch" — the AI knows the context. - **Work** — during work, Claude records valuable knowledge (Capture-to-Pack). Insights are not lost. - **Close** — the result is recorded, the plan is updated, and the next session will begin where you left off. Skipping Open = unplanned work. Skipping Close = lost results. ### Exocortex — External Memory Your knowledge, principles, distinctions, plans, and context are stored in files that Claude reads in every session. This is not a "prompt" — it is an **accumulated base** that grows with you. ### Knowledge Formalization (Pack) What you learn does not stay in your head. Valuable knowledge is formalized into Pack — a passport for the subject area. Pack is the single source-of-truth for domain knowledge. Details: [LEARNING-PATH.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/LEARNING-PATH.md). --- ## For Whom Every professional drowns in information: 12+ tools (Notion, Google Docs, Slack, ChatGPT, courses...), knowledge is scattered, nothing is connected. AI can take into account the project materials available to it, but decisions from different tools are difficult to keep in a single relevant working context. IWE is for those who want to change this: - **Entrepreneurs and Managers** — strategizing, making decisions, managing projects. IWE provides a system: from weekly planning to formalizing domain knowledge - **Engineers and Developers** — working with code and architecture. IWE preserves context between sessions; the AI knows your codebase, technical debt, roadmap - **Researchers and Analysts** — studying, synthesizing, publishing. IWE turns scattered notes into a structured knowledge base that grows with you - **Anyone doing intellectual work** — who wants **symbiosis with AI**, not dependence on it. An exoskeleton for thinking, not a prosthetic --- ## Use Cases ### Work Projects | Scenario | What happens | Details | |----------|---------------|-----------| | **Product Development** | Claude knows the architecture, technical debt, and roadmap. Each session is a continuation, not starting from scratch | [SC.013](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc013-рабочая-сессия-с-claude-code), [SC.015](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc015-развитие-системы-ds) | | **Documentation Management** | Knowledge is recorded in Pack during work. No need to "write docs later" — they are written while working | [SC.004](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc004-фиксация-и-экстракция-знаний), [SC.014](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc014-формализация-знаний-pack) | | **Project Coordination** | WeekPlan, DayPlan, registry of work products — Strategist helps plan and track progress | [SC.001](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc001-планирование-дня), [SC.002](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc002-планирование-и-ревью-недели) | | **Review and Refactoring** | ArchGate evaluates solutions against 7 characteristics. Not just "it seems good to me," but a structured assessment | [SC.015](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc015-развитие-системы-ds) | ### Personal Development | Scenario | What happens | Details | |----------|---------------|-----------| | **Taking a Course** | Claude helps record key ideas, asks questions to verify understanding, connects new material with what you already know | [SC.003](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc003-обучение-и-развитие) | | **Writing Articles** | Creative pipeline: note → draft → outline → publication. Each artifact is tracked | [SC.005](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc005-публикация-контента) | | **Strategizing** | Weekly session: review of the previous week, planning for the new one, alignment with goals. Strategist prepares a draft — you make decisions | [SC.011](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc011-стратегирование) | | **Building a Knowledge Base** | Your Pack grows. In six months, you have a formalized domain knowledge base, not just a collection of notes | [SC.014](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc014-формализация-знаний-pack) | > Full catalog of 15 scenarios: **[USE-CASES.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md)** --- ## How it looks in practice - Morning — Strategist creates a plan: Telegram notification + DayPlan file in the repository - Open VS Code → `claude` → Claude knows what's in the plan and suggests starting with priorities - Work — Claude records knowledge as you go (Capture-to-Pack) - Close session — results are recorded, plan updated - Monday — Strategist prepares a draft weekly plan, you discuss it during the strategizing session --- ## Machine Requirements Minimum **4 GiB of free RAM** while Claude Code (or another agent) runs on top of IWE. With less memory — especially on shared servers with multiple users — file read/write tools may periodically fail with messages like `PreToolUse hook did not respond before its timeout`. This message indicates insufficient host process memory, not template hook failure (issue [#461](https://github.com/TserenTserenov/FMT-exocortex-template/issues/461)) — `bash scripts/iwe-audit.sh` shows current available memory level in the "Available Memory" section. ## Getting Started **Quick Start** (Git, Node.js, Claude Code already installed): **[QUICK-START.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/QUICK-START.md)** -- 15 minutes until first session. **Full Installation** from a clean computer: **[SETUP-GUIDE.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/SETUP-GUIDE.md)** -- 30-60 minutes including all dependency installations. **Not on macOS or not using Claude Code?** Read **[PORTABILITY.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/PORTABILITY.md)** — instructions for Kimi Code, Hermes Agent, and others. **A different agent or LLM?** IWE is not tied to Claude. If your agent can see files in the repo folder and edit files, it will work. How to connect → [PORTABILITY.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/PORTABILITY.md). ```bash mkdir -p ~/IWE && cd ~/IWE gh repo fork TserenTserenov/FMT-exocortex-template --clone cd FMT-exocortex-template bash setup.sh ``` After installation: ```bash cd ~/IWE claude ``` Then tell Claude: **«Проведём первую стратегическую сессию»** to walk through goal setting, the first plan, and environment configuration. --- ## Customization IWE is updated as a distribution. Platform updates arrive without losing personal settings. **Extensions (extensions/)** add blocks to protocols: ```bash # Добавить рефлексию в конце дня echo "## Рефлексия дня - Что было сложным? - Что бы сделал иначе? - За что похвалить?" > extensions/day-close.after.md ``` **Parameters (params.yaml)** — enable/disable protocol steps: ```yaml reflection_enabled: true # Включить рефлексию video_check: false # Отключить проверку видео multiplier_enabled: true # Мультипликатор IWE ``` **Updates** — `bash update.sh` updates the platform while preserving your `extensions/`, `params.yaml`, and edits to `CLAUDE.md` (3-way merge). More details: [extensions/README.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/extensions/README.md) --- ## Documentation | Document | Contents | |----------|-----------| | **[Onboarding Guide](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/onboarding/onboarding-guide.md)** | Start here if you are new to IWE. What it is, why it exists, and its components -- without technical jargon | | **[Quick Start](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/QUICK-START.md)** | 15 minutes from `git clone` to your first session. For those who already have Git and Claude Code | | **[SETUP-GUIDE.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/SETUP-GUIDE.md)** | Step-by-step installation from a clean computer. Requirements, modes (core/full), verification | | **[LEARNING-PATH.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/LEARNING-PATH.md)** | The IWE learning path: architecture, principles, protocols, Pack, roles | | **[DATA-POLICY.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/DATA-POLICY.md)** | Data policy: what is collected, where it is stored, how to delete | | **[DATA-RESIDENCY.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/DATA-RESIDENCY.md)** | Residency principle: data you bring into IWE from outside (health, calendar, work hours) -- where it can and cannot go | | **[IWE-HELP.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/IWE-HELP.md)** | Quick reference and FAQ | | **[principles-vs-skills.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/principles-vs-skills.md)** | Why principles matter more than skills: the generative hierarchy | | **[ONTOLOGY.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/ONTOLOGY.md)** | Ontology: all IWE terms and abbreviations | | **[CHANGELOG.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/CHANGELOG.md)** | History of template changes | > Two documents cover related topics: `DATA-POLICY.md` covers data the platform collects about you; `DATA-RESIDENCY.md` covers data you yourself bring into IWE from outside. --- ## FAQ **Q: Is an Anthropic subscription required?** A: For full installation (Claude Code), Claude Pro ($20/month) is recommended. If needed, you can upgrade to Claude Max (~$100/month) for unrestricted work. For minimal installation (`setup.sh --core`), it works with any AI CLI. More details: [SETUP-GUIDE.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/SETUP-GUIDE.md). **Q: Does it work with other AIs (not Claude)?** A: Yes, three agents are supported out of the box: - **Claude Code** — full support: reads `CLAUDE.md`, all skills and hooks work. - **Kimi Code** (VS Code) — automatically reads `AGENTS.md` when opening the repo. Customization: `extensions/` or `AGENTS-agent-blocks.md`. Skills (`/day-open`, etc.) via Claude Code. - **Hermes Agent** — connect Aisystant MCP through Hermes settings, and it will receive instructions automatically. For other agents (Cursor, Copilot, Gemini), adaptation is required. More details: [PORTABILITY.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/PORTABILITY.md). The minimal installation (`setup.sh --core`) works without binding to a specific agent. **Q: Does it work on Linux/Windows?** A: Standard scenarios work on macOS and Linux; the Strategist automation uses launchd and systemd respectively, with the cloud variant using GitHub Actions. On Windows, individual parts have been verified via Git Bash with native Python (Strategist lock, #1030), but `session-guard.sh` and session opening require WSL2: in native Git Bash, they fail beforehand due to Unix `fcntl` locking (#1032). Full installation and updating of IWE on Windows remain unverified — more details: [SETUP-GUIDE.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/SETUP-GUIDE.md) § Windows. **Q: What if the computer is turned off or sleeping — will automation stop?** A: Cloud Scheduler (GitHub Actions) runs in the cloud even when your computer is turned off. For local agents: scripts automatically prevent sleep during operation (macOS: `caffeinate`, Linux: `systemd-inhibit`). For laptops, it is recommended to configure automatic wake-up and disable idle sleep — see [SETUP-GUIDE.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/SETUP-GUIDE.md). **Q: What is a Pack?** A: A formalized domain of knowledge — the single source-of-truth for domain knowledge. Details: [LEARNING-PATH.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/LEARNING-PATH.md). **Q: Are my data safe?** A: Three protection zones: local, GitHub (private repos), platform (per-user isolation). Details: [DATA-POLICY.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/DATA-POLICY.md). **Q: How does IWE differ from Obsidian / Notion / Logseq?** A: Obsidian is a note storage tool. IWE is a **work environment** with protocols, AI agents, and knowledge formalization. For notes, you can open a separate governance repository (`DS-strategy`) in Obsidian as a vault. The root of IWE (`~/IWE`) is not supported as an Obsidian vault because it may contain very large Markdown files (e.g., `FPF/FPF-Spec.md`), which can cause Obsidian to display a white screen. The entire workspace can be safely viewed via VS Code. **Q: Do I need to know programming?** A: No. The template is a ready-made configuration. Installation is done via setup.sh. Work is conducted through Claude Code using natural language. **Q: Can I use it without the Strategist?** A: Yes. Claude Code + CLAUDE.md + memory/ work fully. The Strategist automates planning. Without it, you plan manually. **Q: How do I set up the strategy day?** A: In `memory/day-rhythm-config.yaml`, change `strategy_day: sunday` to your desired day. Details: [LEARNING-PATH.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/LEARNING-PATH.md). **Q: Did cloning end up in `~` instead of `~/IWE`?** A: All installation commands must be executed in the same terminal session. If you opened a new one, it starts from `~`. Delete the folder from `~` and repeat with `cd ~/IWE`. Details: [SETUP-GUIDE.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/SETUP-GUIDE.md). > Full FAQ with detailed answers: [DP.IWE.002 §11](https://github.com/TserenTserenov/PACK-digital-platform/blob/main/pack/digital-platform/02-domain-entities/DP.IWE.002-iwe-template-and-setup.md#11-частые-вопросы-faq). Practical handbook: [LEARNING-PATH §11](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/LEARNING-PATH.md#11-быстрый-справочник). --- ## IWE Community IWE is an environment you build alone. But you develop it together. The **IWE Community** is a closed chat of practitioners who work within the same system: ORZ, Pack, exocortex. It is a place where they discuss not "how to prompt better," but how to seriously build intellectual work. ### What happens there - **Work product reviews** — participants show real Packs, plans, retrospectives. They receive feedback from people who understand what "closing without recording results" means. - **Experience with installing and customizing IWE** — what broke, how it was fixed, which extensions proved useful. - **Discussion of methods** — ORZ fractal, ArchGate, Capture-to-Pack in practice: what works, where theory diverges from reality. - **Links and findings** — tools, patterns, SOTA that fit into the IWE philosophy. ### Why this matters Studying the system alone is possible. But most questions arise at the application stage: "How to formalize this domain of knowledge?", "Am I using ORZ correctly?", "Who has experience with this tool?" In the community, these questions get answered by people who have already gone through this. ### Free channels - [GitHub Discussions](https://github.com/TserenTserenov/FMT-exocortex-template/discussions) — questions, ideas, show your setup - [Issues](https://github.com/TserenTserenov/FMT-exocortex-template/issues) — bug reports and feature requests ### Closed Community (Telegram) Deep practice, reviews of working products, direct support. Access via the seminar **«IWE for Practitioners»** (5000₽) in the bot [@aist_me_bot](https://t.me/aist_me_bot). --- ## Contributing See [CONTRIBUTING.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/CONTRIBUTING.md) — how to help the project. **For IWE team developers (T4+ level):** single entry point — [Developer Getting Started Guide](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/developer/). In 10 minutes you will understand the development pipeline (6 stations, double output) and complete your first task. --- ## License MIT ## Source and license [Source](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/README.md) · [License](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/LICENSE) · `415d61a98cd2dc471480b3ad01ece6648d814181` MIT License Copyright (c) 2026 Tseren Tserenov Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. --- # IWE:智能工作环境模板 MIT 许可的智能工作环境模板:通过 ОРЗ 会话仪式、Pack 知识形式化、Стратег 规划与外部记忆目录,让 AI 会话延续先前上下文。 # 快速使用 IWE(Intellectual Work Environment,智能工作环境)是来自 TserenTserenov/FMT-exocortex-template 的 MIT 许可仓库模板(版本 0.41.10)。通过 fork 该仓库,它会成为你的个人环境,让 AI 智能体带着持续上下文工作。 项目把 IWE 定位为“面向思考的 IDE”,而非面向代码的 IDE:以外部记忆(exocortex,存放计划、上下文、结论的文件)、原则、ОРЗ 仪式(Открытие → Работа → Закрытие)与架构门(АрхГейт)替代编辑器/编译器/调试器。环境被描述为可运行在任何 AI 平台之上的平台无关层,文档中记录了 Claude Code、Kimi Code 与 Hermes Agent 的支持情况。 source reviewed; runtime not tested(已审阅来源;未做运行验证)。 ## 简介 IWE 旨在解决工作上下文在不同工具和 AI 服务之间分散的问题。它提供了一个结构化的环境来捕获知识、规划工作并保持会话间的连续性。主要组件包括: * **外部记忆 (Exocortex)**:包含计划、上下文和结论的外部记忆文件。 * **ОРЗ 协议**:每个会话和每天的仪式(开启 → 工作 → 关闭),防止上下文丢失。 * **Pack**:特定领域的形式化知识库。 * **战略家 (Strategist)**:用于自动化每日/每周规划的 AI 智能体。 ## 前提条件 根据 README,前提条件包括: * Git、Node.js,完整流程还需要 Claude Code。 * 在 IWE 之上运行 Claude Code(或其他智能体)时,至少需要 4 GiB 空闲内存。内存不足时工具读写可能间歇失败并出现 `PreToolUse hook did not respond before its timeout` 提示。 * 快速开始使用 fork 方式,需要 GitHub 账号与 `gh` CLI。 ## 权限与限制 * **许可**:MIT(Copyright (c) 2026 Tseren Tserenov)。Fork 与自定义是预期的使用方式。 * **数据处理**:描述了三层保护区域——本地、GitHub(私有仓库)、平台(按用户隔离)。细节见 `docs/DATA-POLICY.md` 与 `docs/DATA-RESIDENCY.md`。 * **平台支持**:macOS 与 Linux 有完整场景。Windows 上仅部分功能通过 Git Bash 配合原生 Python 验证;由于 Unix 锁问题,`session-guard.sh` 与会话开启需要 WSL2。Windows 上的完整安装与更新仍未验证。 * **无运行验证**:本指南未在真实环境中执行或测试。 ## 安装设置 快速开始(已安装 Git、Node.js、Claude Code): ```bash mkdir -p ~/IWE && cd ~/IWE gh repo fork TserenTserenov/FMT-exocortex-template --clone cd FMT-exocortex-template bash setup.sh ``` 安装完成后: ```bash cd ~/IWE claude ``` 然后对 Claude 说:**«Проведём первую стратегическую сессию»**,它会带你确定目标、制定第一个计划并配置环境。 从干净电脑开始的完整安装见 `docs/SETUP-GUIDE.md`(30–60 分钟)。最小化的 `setup.sh --core` 变体可与任何 AI CLI 配合使用。不在 macOS 或不用 Claude Code 的读者可参见 `docs/PORTABILITY.md`。 ## 自定义 IWE 以发行版方式更新:平台更新不会丢失个人设置。 **扩展(`extensions/`)** 可为协议添加自定义块: ```bash # Добавить рефлексию в конце дня echo "## Рефлексия дня - Что было сложным? - Что бы сделал иначе? - За что похвалить?" > extensions/day-close.after.md ``` **参数(`params.yaml`)** 可开关协议步骤: ```yaml reflection_enabled: true # Включить рефлексию video_check: false # Отключить проверку видео multiplier_enabled: true # Мультипликатор IWE ``` **更新** —— `bash update.sh` 更新平台,同时保留你的 `extensions/`、`params.yaml` 与对 `CLAUDE.md` 的修改(三方合并)。 ## 仓库家族 外部记忆不是一个仓库,而是一组边界清晰的文件家族: | 家族 | 存放内容 | 示例名称 | |---|---|---| | Base(`ZP`/`FPF`/`SPF`/`FMT-*`) | 平台的原则与格式 —— 现成提供 | `ZP`、`FPF` | | `PACK-*` | 形式化的领域知识(source-of-truth) | `PACK-my-domain` | | `DS-*` | 代码、计划、课程 —— Pack 的衍生内容 | `DS-strategy` | | `PD-*` | 单一类型的个人数据(不含代码) | `PD-persona`、`PD-metrics` | | `MC-*` | 智能体数据(对话、服务日志)—— 人不会日常阅读 | `MC-sessions` | ## 常见问题 **Q:需要 Anthropic 订阅吗?** A:完整安装(Claude Code)建议 Claude Pro($20/月),必要时可转为 Claude Max(约 $100/月)以无限制工作。最小化的 `setup.sh --core` 路径可与任何 AI CLI 配合。见 `docs/SETUP-GUIDE.md`。 **Q:能否配合 Claude 以外的 AI 工具?** A:可以,开箱即用记录了三种智能体:Claude Code(通过 `CLAUDE.md` 提供完整支持)、VS Code 中的 Kimi Code(打开仓库时自动读取 `AGENTS.md`)、Hermes Agent(连接 Aisystant MCP)。Cursor、Copilot、Gemini 等其他智能体需要适配。见 `docs/PORTABILITY.md`。 ## 来源与致谢 来源:[TserenTserenov/FMT-exocortex-template](https://github.com/TserenTserenov/FMT-exocortex-template) —— README 审阅于提交 `415d61a98cd2dc471480b3ad01ece6648d814181`。MIT 许可,Copyright (c) 2026 Tseren Tserenov。感谢作者与 IWE 社区公开记录这一环境。source reviewed; runtime not tested(已审阅来源;未做运行验证)。 ## 完整上游材料译文 # IWE — 智能工作环境 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) [![Version](https://img.shields.io/badge/version-0.41.10-blue.svg)](CHANGELOG.md) [![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows%20(partial)-lightgrey.svg)]() [![EN sync](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/TserenTserenov/FMT-exocortex-template/en-draft/badge-data.json)](https://github.com/TserenTserenov/FMT-exocortex-template/tree/en-draft) 开启、工作、关闭——在会话、天、周等各个尺度上相同的循环 > 智能工作的操作系统。你的知识。你的经验。你的环境——运行于任何 AI 平台之上。 > > **仓库类型:** `Base/Formats`(FMT)—— 模板分发版。Fork 后成为带有 AI 智能体的个人环境。 --- ## 问题 AI 助手能够生成文本、代码和答案。但大多数用户面临相同的问题: - **工作上下文分散。** AI 服务可以存储对话和项目材料,但来自其他工具的决策和计划在下一个会话中或对于另一个智能体来说并不总是可用的。 - **知识留在脑海中。** 你上了课、读了书、解决了问题——但一个月后,你无法重现当时的思维过程。 - **AI 替代了思考而非增强思考。** 你得到了答案,但没有变得更胜任。没有 AI,你就回到了零起点。 - **缺乏系统。** 计划在笔记里,任务在脑子里,知识在聊天中。一切支离破碎。 - **时间流逝。** 不清楚自己做了什么、完成了什么、正走向何方。 --- ## 解决方案:面向思维的 IDE **IWE(Intellectual Work Environment,智能工作环境)** —— 智能工作环境。 正如 IDE 将编辑器、编译器和调试器结合为程序员的单一环境一样,IWE 将知识、规划和 AI 智能体结合为思维的单一环境。 | IDE(用于代码) | IWE(用于思维) | |---------------|-------------------| | 编辑器 → 编写代码 | 外部记忆 (Exocortex) → 记录知识 | | 编译器 → 检查语法 | 原则 → 验证决策的正确性 | | 调试器 → 查找错误 | ORZ 协议(开启→工作→关闭) → 发现知识和上下文的丢失 | | Linter → 提高质量 | 架构门 (ArchGate) → 评估架构决策 | | Git → 变更历史 | 战略家 (Strategist) → 工作历史和规划 | > **关键原则:外骨骼,而非假肢。** IWE 增强你的思维,而不是取代它。每次会话后,你会变得更胜任,而不仅仅是获得结果。详情见:[principles-vs-skills.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/principles-vs-skills.md)。 ## IWE 关键术语 | 术语 | 含义 | |--------|---------| | **外部记忆 (Exocortex)** | 你的外部记忆——包含计划、上下文和结论的文件,Claude 会在每个会话中读取这些文件 | | **Pack** | 您所在领域的形式化知识库——领域知识的唯一真实来源 (source-of-truth) | | **ORZ** | 开启 → 工作 → 关闭——每个会话和每天的仪式,防止上下文丢失 | | **架构门 (ArchGate)** | 基于 7 个特征对架构决策进行结构化评估(代替“我觉得这很好”) | | **战略家 (Strategist)** | 自动制定每日/每周计划并跟踪进度的 AI 智能体 | | **5 个仓库家族** | 用于分离代码、知识和数据的推荐结构——见下文 | 完整术语表:[ONTOLOGY.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/ONTOLOGY.md) ### 5 个仓库家族 外部记忆(Exocortex)不是一个单一的仓库,而是一组边界清晰的集合:代码、领域知识和个人数据互不混合。`setup.sh` 会创建最小化起点(你的战略仓库 + 3 个基础原则仓库);其余部分根据需要创建。 | 家族 | 存储内容 | 示例名称 | |---|---|---| | Base(`ZP`/`FPF`/`SPF`/`FMT-*`) | 平台的原则与格式 —— 现成提供 | `ZP`, `FPF` | | `PACK-*` | 形式化的领域知识(唯一事实来源) | `PACK-my-domain` | | `DS-*` | 代码、计划、课程 —— Pack 的衍生内容 | `DS-strategy` | | `PD-*` | 单一类型的个人用户数据(不含代码) | `PD-persona`, `PD-metrics` | | `MC-*` | 智能体数据(对话、服务日志)—— 人不会日常阅读 | `MC-sessions` | 详细的数据域映射及理由:[ADR-004](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/adr/ADR-004-data-domain-map.md)。 --- ## 工作文化 —— 与 AI 交互的新风格 IWE 不仅仅是一套提示词。它是一种**工作文化**:由 14 个要素(协议、技能、格式)组成,将混乱的 AI 交互转化为可控的流程。详情见:[DP.M.008 — IWE 运营规则](https://github.com/TserenTserenov/PACK-digital-platform/blob/main/pack/digital-platform/03-methods/DP.M.008-iwe-operating-rules.md)。 ### ОРЗ 协议(开启 → 工作 → 关闭) 每个会话和每一天都经历三个阶段: - **开启** —— Claude 检查计划,定义任务,并商定方法。你不是“从零开始”工作 —— AI 了解上下文。 - **工作** —— 在工作过程中,Claude 记录有价值的知识(捕获至 Pack)。洞察不会丢失。 - **关闭** —— 结果已记录,计划已更新,下一个会话将从你停止的地方继续。 跳过开启 = 无计划的工作。跳过关闭 = 丢失的结果。 ### 外部记忆(Exocortex)—— 外部存储器 你的知识、原则、区分、计划和上下文存储在文件中,Claude 在每次会话中都会读取这些文件。这不是“提示词”,而是一个随着你一起成长的**积累库**。 ### 知识形式化(Pack) 你学到的东西不会只留在脑海里。有价值的知识被形式化为 Pack —— 主题领域的护照。Pack 是领域知识的唯一事实来源。详情见:[LEARNING-PATH.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/LEARNING-PATH.md)。 --- ## 适用人群 每位专业人士都淹没在信息中:12+ 个工具(Notion、Google Docs、Slack、ChatGPT、课程……),知识分散,毫无关联。AI 可以利用其可用的项目材料,但来自不同工具的决策很难保持在同一个相关的当前工作上下文中。 IWE 适用于希望改变这一现状的人: - **企业家和管理者** —— 制定战略、做出决策、管理项目。IWE 提供一套系统:从每周规划到领域知识的形式化 - **工程师和开发人员** —— 处理代码和架构。IWE 保留会话间的上下文;AI 了解你的代码库、技术债务和路线图 - **研究人员和分析人员** —— 研究、综合、发布。IWE 将零散的笔记转化为一个随你一起成长的结构化知识库 - **所有从事智力工作的人** —— 希望与 AI 实现**共生**,而非依赖它。这是思维的外骨骼,而非假肢 --- ## 使用场景 ### 工作项目 | 场景 | 发生的情况 | 详情 | |----------|---------------|-----------| | **产品开发** | Claude 了解架构、技术债务和路线图。每次会话都是延续,而非从零开始 | [SC.013](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc013-рабочая-сессия-с-claude-code), [SC.015](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc015-развитие-системы-ds) | | **文档管理** | 知识在工作过程中记录到 Pack 中。无需“稍后写文档”——它们是在工作时同步编写的 | [SC.004](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc004-фиксация-и-экстракция-знаний), [SC.014](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc014-формализация-знаний-pack) | | **项目协调** | 周计划、日计划、工作产品清单——战略家帮助规划并跟踪进度 | [SC.001](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc001-планирование-дня), [SC.002](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc002-планирование-и-ревью-недели) | | **审查与重构** | 架构门(АрхГейт)根据 7 项特征评估解决方案。不是“我觉得不错”,而是结构化评估 | [SC.015](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc015-развитие-системы-ds) | ### 个人发展 | 场景 | 发生什么 | 详情 | |----------|---------------|-----------| | **学习课程** | Claude 帮助记录关键观点,提出问题以验证理解,将新内容与已知内容联系起来 | [SC.003](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc003-обучение-и-развитие) | | **撰写文章** | 创意流水线:笔记 → 草稿 → 大纲 → 发布。每个工件都可追踪 | [SC.005](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc005-публикация-контента) | | **战略规划** | 每周会话:回顾上周,规划下周,与目标对齐。战略家准备草案——你做出决策 | [SC.011](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc011-стратегирование) | | **构建知识库** | 你的 Pack 不断增长。半年后,你将拥有一个形式化的领域知识库,而不仅仅是笔记集合 | [SC.014](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md#sc014-формализация-знаний-pack) | > 包含 15 个场景的完整目录:**[USE-CASES.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/use-cases/USE-CASES.md)** --- ## 实际运作方式 - 早晨——战略家制定计划:Telegram 通知 + 仓库中的 DayPlan 文件 - 打开 VS Code → `claude` → Claude 知道计划内容,并建议优先处理事项 - 工作中——Claude 在过程中记录知识(Capture-to-Pack) - 结束会话——结果已记录,计划已更新 - 周一——战略家准备周计划草案,你在战略规划会话中讨论它 --- ## 机器要求 在 IWE 之上运行 Claude Code(或其他智能体)时,至少需要 **4 GiB 空闲内存**。内存不足时——尤其是在多用户共享服务器上——文件读写工具可能会间歇性失败,并出现类似 `PreToolUse hook did not respond before its timeout` 的消息。此消息表明主机进程内存不足,而非模板钩子故障(问题 [#461](https://github.com/TserenTserenov/FMT-exocortex-template/issues/461))——`bash scripts/iwe-audit.sh` 会在“可用内存”部分显示当前可用内存水平。 ## 开始使用 **快速开始**(已安装 Git、Node.js、Claude Code):**[QUICK-START.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/QUICK-START.md)** —— 15 分钟即可进行首次会话。 **完整安装**(从干净电脑开始):**[SETUP-GUIDE.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/SETUP-GUIDE.md)** —— 30-60 分钟,包括所有依赖项的安装。 **不在 macOS 上或未使用 Claude Code?** 请阅读 **[PORTABILITY.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/PORTABILITY.md)** — 适用于 Kimi Code、Hermes Agent 及其他工具的说明。 **其他智能体或大语言模型 (LLM)?** IWE 不绑定于 Claude。如果你的智能体能查看仓库文件夹中的文件并编辑文件,它即可运行。如何连接 → [PORTABILITY.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/PORTABILITY.md)。 ```bash mkdir -p ~/IWE && cd ~/IWE gh repo fork TserenTserenov/FMT-exocortex-template --clone cd FMT-exocortex-template bash setup.sh ``` 安装完成后: ```bash cd ~/IWE claude ``` 然后对 Claude 说:**«Проведём первую стратегическую сессию»**,它会带你确定目标、制定第一个计划并配置环境。 --- ## 自定义 IWE 以发行版方式更新:平台更新不会丢失个人设置。 **扩展(extensions/)** 可为协议添加自定义块: ```bash # Добавить рефлексию в конце дня echo "## Рефлексия дня - Что было сложным? - Что бы сделал иначе? - За что похвалить?" > extensions/day-close.after.md ``` **参数(`params.yaml`)** 可开关协议步骤: ```yaml reflection_enabled: true # Включить рефлексию video_check: false # Отключить проверку видео multiplier_enabled: true # Мультипликатор IWE ``` **更新** —— `bash update.sh` 更新平台,同时保留你的 `extensions/`、`params.yaml` 与对 `CLAUDE.md` 的修改(三方合并)。 更多详情:[extensions/README.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/extensions/README.md) --- ## 文档 | 文档 | 内容 | |----------|-----------| | **[新手指南](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/onboarding/onboarding-guide.md)** | 如果你是第一次听说 IWE,请从这里开始。它是什么、为何存在、由什么组成——无需技术术语 | | **[快速入门](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/QUICK-START.md)** | 从 `git clone` 到第一次会话仅需 15 分钟。适用于已拥有 Git 和 Claude Code 的用户 | | **[SETUP-GUIDE.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/SETUP-GUIDE.md)** | 从干净电脑开始的逐步安装。要求、模式(核心/完整)、验证 | | **[学习路径](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/LEARNING-PATH.md)** | IWE 的学习路径:架构、原则、协议、Pack、角色 | | **[数据政策](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/DATA-POLICY.md)** | 数据政策:收集什么、存储在哪里、如何删除 | | **[数据驻留](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/DATA-RESIDENCY.md)** | 驻留原则:你从外部带入 IWE 的数据(健康、日历、工作时间)——可以去哪里、不能去哪里 | | **[IWE 帮助](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/IWE-HELP.md)** | 快速参考与常见问题解答 | | **[原则 vs 技能](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/principles-vs-skills.md)** | 为什么原则比技能更重要:生成式层级 | | **[本体论](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/ONTOLOGY.md)** | 本体论:所有 IWE 术语和缩写 | | **[更新日志](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/CHANGELOG.md)** | 模板变更历史 | > 两份文档涵盖相关主题:`DATA-POLICY.md` 涉及平台收集的关于你的数据;`DATA-RESIDENCY.md` 涉及你自己从外部带入 IWE 的数据。 --- ## 常见问题 **Q:需要 Anthropic 订阅吗?** A:对于完整安装(Claude Code),推荐 Claude Pro($20/月)。如有需要,可升级为 Claude Max(约 $100/月)以无限制工作。对于最小化安装(`setup.sh --core`),可与任何 AI CLI 配合使用。更多详情:[SETUP-GUIDE.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/SETUP-GUIDE.md)。 **Q:能否配合其他 AI(非 Claude)使用?** A:可以,开箱即用支持三种智能体: - **Claude Code** —— 完整支持:读取 `CLAUDE.md`,所有技能和钩子均有效。 - **Kimi Code**(VS Code)—— 打开仓库时自动读取 `AGENTS.md`。自定义方式:`extensions/` 或 `AGENTS-agent-blocks.md`。技能(`/day-open` 等)通过 Claude Code 调用。 - **Hermes Agent** —— 在 Hermes 设置中连接 Aisystant MCP,它将自动接收指令。 对于其他智能体(Cursor、Copilot、Gemini),需要进行适配。更多详情:[PORTABILITY.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/PORTABILITY.md)。 最小化安装(`setup.sh --core`)无需绑定特定智能体即可运行。 **Q:能在 Linux/Windows 上运行吗?** A:macOS 和 Linux 支持标准场景;战略家自动化分别使用 launchd 和 systemd,云变体使用 GitHub Actions。在 Windows 上,部分功能已通过 Git Bash 配合原生 Python 验证(战略家锁,#1030),但 `session-guard.sh` 与会话开启需要 WSL2:在原生 Git Bash 中,由于 Unix `fcntl` 锁定问题(#1032),它们会提前失败。Windows 上的 IWE 完整安装与更新仍未验证——更多详情:[SETUP-GUIDE.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/SETUP-GUIDE.md) § Windows。 **Q:如果计算机关闭或睡眠——自动化会停止吗?** A:Cloud Scheduler(GitHub Actions)即使在计算机关闭时也在云端运行。对于本地智能体:脚本会在运行期间自动防止系统进入睡眠状态(macOS:`caffeinate`,Linux:`systemd-inhibit`)。对于笔记本电脑,建议配置自动唤醒并禁止空闲睡眠——详见 [SETUP-GUIDE.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/SETUP-GUIDE.md)。 **问:什么是 Pack?** A:形式化的知识领域——作为领域知识的单一真实来源(source-of-truth)。详情见:[LEARNING-PATH.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/LEARNING-PATH.md)。 **问:我的数据安全吗?** A:三层保护区域:本地、GitHub(私有仓库)、平台(按用户隔离)。详情见:[DATA-POLICY.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/DATA-POLICY.md)。 **问:IWE 与 Obsidian / Notion / Logseq 有何不同?** A:Obsidian 是一个笔记存储工具。IWE 是一个具备协议、AI 智能体和知识形式化的**工作环境**。对于笔记,你可以在 Obsidian 中打开一个单独的管理仓库(`DS-strategy`)作为 vault。IWE 的根目录(`~/IWE`)不支持作为 Obsidian vault,因为它可能包含非常大的 Markdown 文件(例如 `FPF/FPF-Spec.md`),这会导致 Obsidian 显示白屏。整个工作区可以通过 VS Code 安全地查看。 **问:需要编程吗?** A:不需要。模板是现成的配置。通过 setup.sh 进行安装。工作通过 Claude Code 使用自然语言进行。 **问:可以没有战略家吗?** A:可以。Claude Code + CLAUDE.md + memory/ 可以完全正常工作。战略家用于自动化规划。如果没有它,你需要手动规划。 **问:如何设置战略日?** A:在 `memory/day-rhythm-config.yaml` 中将 `strategy_day: sunday` 更改为你想要的日期。详情见:[LEARNING-PATH.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/LEARNING-PATH.md)。 **问:克隆到了 `~` 而不是 `~/IWE`?** A:所有安装命令必须在同一个终端会话中执行。如果你打开了一个新的终端,它会从 `~` 开始。删除 `~` 中的文件夹,然后使用 `cd ~/IWE` 重新执行。详情见:[SETUP-GUIDE.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/SETUP-GUIDE.md)。 > 包含详细答案的完整常见问题解答:[DP.IWE.002 §11](https://github.com/TserenTserenov/PACK-digital-platform/blob/main/pack/digital-platform/02-domain-entities/DP.IWE.002-iwe-template-and-setup.md#11-частые-вопросы-faq)。实用手册:[LEARNING-PATH §11](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/LEARNING-PATH.md#11-быстрый-справочник)。 --- ## IWE 社区 IWE 是你独自构建的环境,但你是与他人共同发展的。 **IWE 社区**是一个封闭的实践者聊天室,他们都在同一套系统下工作:ОРЗ、Pack、外部记忆。这里讨论的不是“如何更好地提示”,而是如何认真地进行智力工作建设。 ### 那里发生了什么 - **工作产品评审**——参与者展示真实的 Pack、计划、回顾。他们从理解“未记录结果即关闭”含义的人那里获得反馈。 - **安装和自定义 IWE 的经验**——什么坏了,怎么修好的,哪些扩展被证明是有用的。 - **方法讨论**——ОРЗ 分形、架构门、Capture-to-Pack 在实践中:什么有效,理论与现实在哪里分歧。 - **链接和发现**——符合 IWE 哲学的工具、模式、SOTA(最新技术水平)。 ### 为什么这很重要 独自学习系统是可能的。但大多数问题出现在应用阶段:“如何形式化这个知识领域?”、“我正确使用 ОРЗ 了吗?”、“谁有这个工具的经验?” 在社区中,这些问题由已经经历过这些的人来回答。 ### 免费渠道 - [GitHub Discussions](https://github.com/TserenTserenov/FMT-exocortex-template/discussions) — 问题、想法,展示你的配置 - [Issues](https://github.com/TserenTserenov/FMT-exocortex-template/issues) — Bug 报告和功能请求 ### 封闭社区(Telegram) 深度实践、工作产品评审、直接支持。通过机器人 [@aist_me_bot](https://t.me/aist_me_bot) 中的研讨会 **«IWE 面向实践者»**(5000₽)进入。 --- ## 参与开发 参见 [CONTRIBUTING.md](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/CONTRIBUTING.md) — 如何帮助该项目。 **IWE 团队开发人员(T4+ 级别):** 统一入口点 — [开发者入门指南](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/docs/developer/)。在 10 分钟内了解开发流水线(6 个工位,双重输出)并完成第一个任务。 --- ## 许可证 MIT ## 来源与许可证 [Source](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/README.md) · [License](https://github.com/TserenTserenov/FMT-exocortex-template/blob/415d61a98cd2dc471480b3ad01ece6648d814181/LICENSE) · `415d61a98cd2dc471480b3ad01ece6648d814181` MIT License Copyright (c) 2026 Tseren Tserenov Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. --- Source: https://tokrepo.com/en/workflows/iwe-intellectual-work-environment-template-b3c7568c Author: Prompt Lab