Skip to content

Repository files navigation

IWE — Intellectual Work Environment

License: MIT Version Platform

Open, Work, Close — the same cycle at every scale: session, day, week

The operating system for intellectual work. Your Knowledge. Your Experience. Your Environment — runs on top of any AI platform.

Repository type: Base/Formats (FMT) — distribution template. 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 problems:

  • Context is lost. Every new AI Session starts from scratch. Yesterday's decisions, plans, and agreements are forgotten.
  • Knowledge stays in your head. You finished a course, read a book, solved a problem — but a month later you cannot reconstruct your reasoning.
  • AI replaces thinking instead of amplifying it. You get an answer, but you do not become more competent. Without AI — back to zero.
  • No system. Plans are in notes, tasks are in your head, Knowledge is scattered across chats. Everything is disconnected.
  • Time disappears. It is unclear what you worked on, what you accomplished, where you are headed.

The Solution: IDE, but for Thinking

IWE (Intellectual Work Environment) is an intellectual work environment.

Just as an IDE combines editor, compiler, and debugger into one environment for a developer — IWE combines Knowledge, planning, and AI agents into one environment for thinking.

IDE (for code) IWE (for thinking)
Editor → write code Exocortex → capture Knowledge
Compiler → checks syntax Principles → verify decision correctness
Debugger → finds errors ORZ Protocols (Opening→Work→Closing) → find Knowledge and context losses
Linter → improves quality ArchGate → assesses architectural decisions
Git → change history Strategist → work history and planning

Core Principle: exoskeleton, not prosthetic. IWE amplifies your thinking — it does not replace it. After every Session you become more competent, not just get a result. More: 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 Opening → Work → Closing — a Ritual for every Session and every day, prevents context loss
ArchGate Structured Assessment of architectural decisions across 7 characteristics (instead of "I think this looks good")
Strategist An AI agent that automatically drafts day/week plans and tracks Progress

Work Culture — A New Way to Interact With AI

The ORZ Protocol (Opening → Work → Closing)

Every Session and every day moves through three stages:

  • Opening — Claude reviews the plan, identifies the task, and aligns on the approach. You do not start work "from scratch" — the AI knows the context.
  • Work — as work proceeds, Claude captures valuable Knowledge (Capture-to-Pack). Insights are not lost.
  • Closing — the result is captured, the plan is updated, and the next Session starts from where you left off.

Skipping Opening = unplanned work. Skipping Closing = lost result.

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 a Pack — a Domain passport. Pack is the single source-of-truth for domain Knowledge. More: LEARNING-PATH.md.


Who It Is For

Every professional drowns in information: 12+ tools (Notion, Google Docs, Slack, ChatGPT, courses…), Knowledge is scattered, nothing is connected. AI answers questions but does not know your context — every time from scratch.

IWE is for those who want to change that:

  • Entrepreneurs and managers — you strategize, make decisions, manage projects. IWE provides a system: from weekly planning to Domain Knowledge formalization.
  • Engineers and developers — you work with code and Architecture. IWE preserves context between Sessions; the AI knows your codebase, tech debt, and Roadmap.
  • Researchers and analysts — you study, synthesize, and publish. IWE turns scattered notes into a structured Knowledge base that grows with you.
  • Everyone who does intellectual work — and wants symbiosis with AI, not dependence on it. An exoskeleton for thinking, not a prosthetic.

Use Cases

Work Projects

Scenario What happens More
Product development Claude knows the Architecture, tech debt, and Roadmap. Every Session is a continuation, not a restart SC.013, SC.015
Documentation Knowledge is captured in Pack as work proceeds. No need to "write docs later" — they are written during the work SC.004, SC.014
Project coordination WeekPlan, DayPlan, Work Product registry — the Strategist helps plan and track Progress SC.001, SC.002
Review and Refactoring ArchGate evaluates decisions across 7 characteristics. Not "I think this is good" — a structured Assessment SC.015

Personal Development

Scenario What happens More
Taking a course Claude helps capture key ideas, asks questions to check Understanding, and connects new material to what you already know SC.003
Writing articles Creative Pipeline: note → draft → outline → publication. Every Artifact is tracked SC.005
Strategizing Weekly Session: Review of the past week, planning the next one, alignment with goals. The Strategist prepares the draft — you make the decisions SC.011
Building a Knowledge base Your Pack grows. After six months you have a formalized Domain Knowledge base, not a collection of notes SC.014

Full catalog of 15 scenarios: USE-CASES.md


What It Looks Like in Practice

  • In the morning — the Strategist has drafted a plan: a Telegram notification and a DayPlan file in the Repository.
  • You open VS Code → claude → Claude knows the plan and offers to start with the top Priority.
  • You work — Claude captures Knowledge along the way (Capture-to-Pack).
  • You close the Session — the result is captured, the plan is updated.
  • On Monday — the Strategist drafts a weekly plan; you discuss it in a strategizing Session.

Getting Started

Quick start (Git, Node.js, Claude Code already installed): QUICK-START.md — 15 minutes to your first Session.

Full setup from a clean machine: SETUP-GUIDE.md — 30–60 minutes including all dependency installation.

Not on macOS or not using Claude Code? Read PORTABILITY.md — instructions for Kimi Code, Hermes Agent, and others.

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.

mkdir -p ~/IWE && cd ~/IWE
gh repo fork iwesys/IWE --clone
cd FMT-exocortex-template
bash setup.sh

After setup:

cd ~/IWE
claude

Tell Claude: "Let's run the first strategic Session" — and it will guide you through defining goals, creating the first plan, and configuring the Environment.


Customization

IWE updates like a distribution — you receive Platform updates without losing your settings.

Extensions (extensions/) — add your own blocks to Protocols:

# Add end-of-day reflection
echo "## Day Reflection
- What was difficult?
- What would I do differently?
- What deserves praise?" > extensions/day-close.after.md

Parameters (params.yaml) — enable or disable Protocol steps:

reflection_enabled: true    # Enable reflection
video_check: false          # Disable video check
multiplier_enabled: true    # IWE multiplier

Updatesbash update.sh updates the Platform while preserving your extensions/, params.yaml, and edits in CLAUDE.md (3-way merge).


Documentation

Document Contents
Beginner's Guide Start here if you are new to IWE. What it is, why it exists, what it consists of — no technical jargon
Quick Start 15 minutes from git clone to your first Session. For those who already have Git and Claude Code
SETUP-GUIDE.md Step-by-step setup from a clean machine. Requirements, modes (core/full), verification
LEARNING-PATH.md The IWE learning path: Architecture, principles, Protocols, Pack, Roles
DATA-POLICY.md Data policy: what is collected, where it is stored, how to delete it
DATA-RESIDENCY.md Residency principle: data you bring into IWE from outside (health, calendar, working hours) — where it may and may not go
IWE-HELP.md Quick reference and FAQ
principles-vs-skills.md Why principles matter more than Skills: the generative hierarchy
CHANGELOG.md Template change history

Two documents cover related topics: DATA-POLICY.md — data the Platform collects about you; DATA-RESIDENCY.md — data you bring into IWE from outside.


FAQ

Q: Is an Anthropic subscription required? A: For full setup (Claude Code) — Claude Pro ($20/month) is recommended. You can upgrade to Claude Max (~$100/month) for unlimited work if needed. For minimal setup (setup.sh --core) — works with any AI CLI. More: SETUP-GUIDE.md.

Q: Does it work with other AI systems (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) — reads AGENTS.md automatically when the repo is opened. Customization: extensions/ or AGENTS-agent-blocks.md. Skills (/day-open etc.) via Claude Code.
  • Hermes Agent — connect the aisystant MCP through Hermes settings and it receives instructions automatically.

For other agents (Cursor, Copilot, Gemini) adaptation is required. More: PORTABILITY.md. Minimal setup (setup.sh --core) works without being tied to a specific agent.

Q: Does it work on Linux/Windows? A: Yes. The core works on any OS. Strategist automation: macOS — launchd, Linux — systemd (user units), cloud option (OS-independent) — GitHub Actions. Windows: setup.sh and the core run via Git Bash (installed with Git for Windows) — WSL is not required; WSL remains a fallback for those who prefer a full Linux layer. Not verified on real Windows hardware (no Windows runner in CI) — details and honest caveats: SETUP-GUIDE.md § Windows.

Q: What if the computer is off or asleep — will automation stop? A: Cloud Scheduler (GitHub Actions) runs in the cloud even when the computer is off. For local agents: scripts automatically prevent sleep during execution (macOS: caffeinate, Linux: systemd-inhibit). For laptops, it is recommended to configure automatic wake and disable idle sleep — see SETUP-GUIDE.md.

Q: What is a Pack? A: A formalized Knowledge Domain — the single source-of-truth for domain Knowledge. More: LEARNING-PATH.md.

Q: Is my data secure? A: Three protection zones: local, GitHub (private repos), Platform (per-user isolation). More: DATA-POLICY.md.

Q: How is IWE different from Obsidian / Notion / Logseq? A: Obsidian is a note storage tool. IWE is a work environment with Protocols, AI agents, and Knowledge formalization. You can use Obsidian inside IWE for notes, but IWE provides structure, planning, and Competency accumulation.

Q: Is programming required? A: No. The template is a ready-made Configuration. Installation via setup.sh. Work via Claude Code in natural language.

Q: Can it be used without the Strategist? A: Yes. Claude Code + CLAUDE.md + memory/ work fully. The Strategist is planning automation. Without it, you plan manually.

Q: How do I set the strategizing day? A: In memory/day-rhythm-config.yaml, change strategy_day: sunday to the desired day. More: LEARNING-PATH.md.

Q: The clone ended up in ~ instead of ~/IWE? A: All setup commands must be run in the same terminal. Opening a new terminal starts from ~. Delete the folder from ~ and repeat with cd ~/IWE. More: SETUP-GUIDE.md.


IWE Community

IWE is an Environment you build alone. But you develop it together.

The IWE Community is a closed chat for Practitioners who work within the same system: ORZ, Pack, Exocortex. A place where the discussion is not "how to prompt better" — but how to build intellectual work seriously.

What Happens There

  • Work Product reviews — participants share real Packs, plans, and Retrospectives. They receive feedback from people who understand what "closing without capturing a result" means.
  • IWE setup and customization Experience — what broke, how it was fixed, which extensions proved useful.
  • Methods discussion — the ORZ fractal, ArchGate, Capture-to-Pack in Practice: what works, where theory diverges from reality.
  • Links and discoveries — tools, patterns, SOTA that fit the IWE philosophy.

Why It Matters

You can learn the system alone. But most questions arise at the application stage: "How do I formalize this Knowledge Domain?", "Am I using ORZ correctly?", "Who has Experience with this tool?"

In the community, these questions get answers from people who have already been through it.

Free Channels

Closed Community (Telegram)

Deep Practice, Work Product reviews, direct support. Entry — through the "IWE for Practitioners" seminar (5000₽) via the bot @aist_me_bot.


Contributing

See CONTRIBUTING.md — how to contribute to the project.

IWE team developers (level T4+): single entry point — Developer Onboarding. In 10 minutes you will understand the development Pipeline (6 stations, dual output) and complete your first task.


License

MIT

About

IWE (Intellectual Work Environment) — an IDE for thinking: protocols, AI-agent roles, memory, and knowledge formalization on top of Claude Code

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors