ProjectCurator

# ProjectCurator

[日本語版はこちら](README-ja.md)

![.NET 9](https://img.shields.io/badge/.NET-9-512BD4?logo=dotnet)
![wpf-ui](https://img.shields.io/badge/wpf--ui-3.x-0078D4)
![Platform](https://img.shields.io/badge/platform-Windows-0078D4?logo=windows)
![License](https://img.shields.io/badge/license-MIT-green)

A Windows desktop app for streamlining project management and context switching.

![Dashboard screenshot](_assets/Dashboard.png)

## Why This App Is Useful

ProjectCurator reduces context switching and cognitive load for both you and your AI agents:

- Project visibility: see project health and today's task signals from one Dashboard
- Context maintenance: quickly track "what I'm doing now" (`current_focus.md`) and "what was decided" (`decision_log`) in a focused editor
- AI Agent readiness: the markdown files maintained here serve perfectly as ready-to-read context files for AI agents like Claude Code or Codex CLI
- Optional Asana integration: sync tasks into Markdown so project status stays visible and searchable

Whether you run many projects in parallel or manage a single complex one, ProjectCurator helps both you and your AI jump straight into the flow state without losing time trying to remember where you left off.

## Who It Is For

- People managing multiple active projects, or one complex long-term project
- Users wanting their local folders completely primed for AI agent collaboration
- Users who want Asana tasks mapped into project Markdown context (Asana is completely optional; the app works great as a standalone context manager)

## Feature Map

```mermaid
flowchart TD
    U["👤 You"] -->|"Check status"| DB["📊 Dashboard"]
    DB -->|"Open"| ED["📝 Editor"]
    ED -->|"Update"| CTX["🧠 current_focus.md / decision_log"]

    U -->|"Sync tasks (optional)"| AS["🔄 Asana Sync"]
    AS -->|"Write"| TASKS["✅ asana-tasks.md"]
    DB -->|"Read"| TASKS
    TASKS -->|"Feed to LLM"| LLM["🤖 LLM (OpenAI / Azure)"]
    DB -->|"What's Next (AI)"| LLM
    LLM -->|"Propose update"| ED
    LLM -->|"Suggest actions"| DB

    U -->|"Manage folders"| SU["🧰 Setup"]
    U -->|"Review activity"| TL["🕒 Timeline"]
    U -->|"Scan repositories"| GR["🌿 Git Repos"]
    U -->|"Manage sub-agents/rules"| AH["🧩 Agent Hub"]
    U -->|"Configure paths / hotkey / theme"| ST["⚙️ Settings"]

    GR -->|"Show uncommitted changes"| DB
    ST -->|"Apply settings"| DB
    ST -->|"Apply settings"| AS
```

## Core Features

| Page | What You Can Do |
|---|---|
| Dashboard | Project health overview, Today Queue visibility, workstream status checks, AI-powered What's Next suggestions (requires AI Features enabled) |
| Editor | Markdown context editing, search, link open, quick decision log creation, AI-powered "Update Focus from Asana", "AI Decision Log", and "Import Meeting Notes" (all require AI Features enabled) |
| Timeline | Review recent project activity in chronological order |
| Git Repos | Recursively scan workspace roots for repositories |
| Asana Sync | Sync Asana tasks to project/workstream Markdown outputs |
| Agent Hub | Manage reusable sub-agent/context-rule library and deploy/undeploy per project, per CLI (Claude/Codex/Copilot/Gemini) |
| Setup | Create/check/archive projects, tier conversion, workstream management |
| Settings | Theme, hotkey, workspace paths, refresh behavior, LLM API configuration, Enable AI Features toggle |

## Recommended Daily Flow

1. Open `Dashboard`
2. (If AI Features is enabled) Click the What's Next button (💡) to see AI-prioritized action suggestions across all projects
3. Click a project or workstream and open `current_focus.md`
4. Update context in `Editor` and save with `Ctrl+S`
5. Add a `decision_log` entry if needed (when AI Features is enabled, the Dec Log button opens an AI-assisted dialog)
6. If you have meeting notes from a recent meeting, click `Import Meeting Notes` in the Editor toolbar to analyze and apply them
7. If using Asana, run `Asana Sync` to refresh task files
8. If AI Features is enabled, click `Update Focus from Asana` in the Editor toolbar to get an LLM-generated update proposal

```mermaid
flowchart TD
    A["Open Dashboard"] --> B["What's Next (optional, AI)"]
    B --> C["Pick project or workstream"]
    C --> D["Open current_focus.md in Editor"]
    D --> E["Update context and save"]
    E --> F["Add decision_log entry (optional)"]
    F --> G["Run Asana Sync (optional)"]
    G --> H["Update Focus from Asana (optional, AI)"]
```

## Core Context Files

The application relies on maintaining the following Markdown files to preserve project context:

- **`current_focus.md`**
  The "you are here" map of the project. Tracks what you are currently doing and what's next.
- **`tensions.md`**
  A log of open technical questions, unmitigated risks, and unresolved trade-offs.
- **`decision_log/`**
  A structured folder recording "why we chose this" and "what was decided" for critical architecture choices.

## Quick Start (5 Minutes)

### 1. Download the app from GitHub Releases

- Open the [latest GitHub Release](https://github.com/yt3trees/ProjectCurator/releases)
- Download the `.zip` file
- Extract it to any folder you want (for example, `C:\Tools\ProjectCurator\`)

### 2. Launch `ProjectCurator.exe`

- Double-click `ProjectCurator.exe`
- If Windows SmartScreen appears, click `More info` -> `Run anyway`

### 3. Configure required paths

Open `Settings`, set these values, then save:
*(Note: If you don't use Box/OneDrive or Obsidian, you can simply point these to any local folders on your PC.)*

- `Local Projects Root` (parent folder for your local working projects)
  Example: `C:\Users\<your-user>\Documents\Projects`
- `Cloud Sync Root` (parent folder synced by Box for shared project files)
  Example: `C:\Users\<your-user>\Box\Projects`
- `Obsidian Vault Root` (parent folder for your Obsidian vault, or just a general notes folder)
  Example: `C:\Users\<your-user>\Box\ObsidianVault`

Required config files are created automatically when you save.

### 4. Optional: Set up Asana integration

<details>
<summary>Show Asana setup steps</summary>

- Create/check your Asana token in Developer Console: `https://app.asana.com/0/my-apps`
- Open `Settings` and enter global Asana values
  - `asana_token`
  - `workspace_gid`
  - `user_gid`
- Open `Asana Sync`
- Enable schedule if needed and save
- Run a manual sync once to create/update task files

</details>

### 5. Optional: Set up LLM / AI features

<details>
<summary>Show LLM setup steps</summary>

- Open `Settings` and find the `LLM API` section
- Choose a provider: `openai` or `azure_openai`
- Enter your API Key, Model, and (for Azure) Endpoint and API Version
- Click `Test Connection` to verify the credentials
- Once the test passes, toggle `Enable AI Features` to on and save
- The `What's Next` button (💡) will appear in the Dashboard toolbar
- The `Briefing` button (💡) will appear on each project card in Dashboard
- The `Update Focus from Asana` button, the `AI Decision Log` button, and the `Import Meeting Notes` button will appear in the Editor toolbar

</details>

### 6. Create Your First Project

Let's use the Setup page to create your first project.

1. **Open the `Setup` page**
2. **Type your project name into `Project Name`** (e.g., `TestProject`)
3. **Click `Setup Project`**
   *(This automatically creates the folder structure and required Markdown files)*
4. **Go to `Dashboard` to see your new project**
5. **Open `Editor` and start updating `current_focus.md`**

Your environment is now ready. Configure Asana Sync later if needed.

## Folder Layout (Local vs Cloud Sync)

<details>
<summary>View basic folder structure</summary>

```mermaid
flowchart LR
    L["Local Projects Root (local disk)"]
    B["Cloud Sync Root (remote sync)"]
    O["Obsidian Vault Root (notes sync)"]

    L --> P["MyProject/development/source (local)"]
    L --> J1["MyProject/shared (junction)"]
    L --> J2["MyProject/_ai-context/context (junction)"]
    L --> J3["MyProject/_ai-context

[truncated…]