m-pps-v1-1

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

---

# 🧭 Modular Personal Productivity System (M-PPS)

### **A Minimal, Executable AI-Native Personal Operating System**

### *Built on Structure DNA → M-PPS → LLC → Claude Skills*

---

## 🧩 Overview

**M-PPS (Modular Personal Productivity System)** is a lightweight yet complete, executable personal operating system built entirely through **language → structure → scheduling**.

This repository provides:

- **Four core structural protocols**
- **Four Claude Skills** implementing the M-PPS runtime
- **Example ledgers** (initial JSON templates)
- **User workflow examples**
- **A minimal, self-consistent cognitive loop**

The system transforms an LLM into:

1. **Language Interpreter** — intent recognition
2. **Structure Compiler** — JSON Structure DNA entries
3. **Scheduler Runtime** — executing the lifecycle state machine
4. **Reflection Engine** — generating feedback & learning

> Every instruction becomes structure.Every structure becomes action.Every action becomes learning.This is the foundation of an AI-Native personal OS.
> 

---

# 📐 System Architecture

```
Language Input (Natural Language)
        ↓
Structure DNA (Unified JSON Schema)
        ↓
M-PPS Modules (Goal, Schedule, Reflection, Profile)
        ↓
Claude Skills (Execution & Dispatch Runtime)
        ↓
Ledger System (goal.json, schedule.json, reflection.json, profile.json)
        ↓
LLC (Language Logic Core: Feedback → Learning)

```

- **Structure DNA** defines fields, timestamp rules, and state machine.
- **M-PPS** provides the modular life-operations model.
- **Claude Skills** implement scheduling & dispatch.
- **Ledgers** act as the OS memory.
- **LLC** closes the loop into a living cognitive system.

---

# 📁 Repository Structure

```
.
├── protocols/
│   ├── structure-dna/v1.0/spec.md
│   ├── m-pps/v1.0/spec.md
│   ├── profile-generator/v1.1.md
│   └── language-logic-core/v1.0.md
│
├── skills/
│   ├── goal-manager/SKILL.md
│   ├── personal-schedule-manager/SKILL.md
│   ├── reflection-manager/SKILL.md
│   └── ledger-registry/SKILL.md
│
├── example-ledgers/
│   ├── goal.json
│   ├── schedule.json
│   ├── reflection.json
│   ├── profile.json
│   └── manifest.json
│
└── README.md

```

---

# 🔧 Core Protocols (Specifications)

The following **four foundational protocols** define the M-PPS ecosystem.

| Protocol | Description |
| --- | --- |
| **Structure DNA v1.0** | Universal schema: fields, timestamps, lifecycle state machine, dispatch semantics |
| **M-PPS Specification v1.0** | Defines the operational modules: Goal, Schedule, Reflection, Profile |
| **Profile Generator v1.1** | Personal preferences: energy cycles, time blocks, scheduling constraints |
| **Language Logic Core (LLC) v1.0** | The meta-cognitive loop: intention → structure → action → reflection → learning |

All Skills and ledgers must align with these specification contracts.

---

# 🧩 Core Skills

This repository includes **four Claude Skills**, which together form a runnable execution loop.

| Skill | Module | Responsibility |
| --- | --- | --- |
| **goal.manager** | Goal | Parse intentions → generate G-entries |
| **personal.schedule.manager** | Schedule | Convert goals into schedulable S-entries |
| **reflection.manager** | Reflection | Capture results, learning, feedback (R-entries) |
| **ledger.registry** | Registry | Maintain manifest, verify ledger structure |

### Skill Summary

---

### **1. goal.manager**

- Understand natural-language intentions
- Create structured Goal entries (`G-xxx`)
- Assign tags & semantic anchors
- Dispatch items into scheduling when ready

---

### **2. personal.schedule.manager**

- Read open goals
- Generate Schedule entries (`S-xxx`)
- Apply temporal semantics
- Track state transitions (`open → scheduled → in_progress → done`)
- Trigger reflection upon completion

---

### **3. reflection.manager**

- Generate feedback entries (`R-xxx`)
- Update goal success ratios
- Produce summary fields
- Close the cognitive loop

---

### **4. ledger.registry**

- Read `manifest.json`
- Validate all ledger files
- Assist other Skills in consistent file writes

---

# 📘 Example Ledgers (Templates)

All example ledgers are stored in:

```
/example-ledgers/

```

They include:

- `goal.json`
- `schedule.json`
- `reflection.json`
- `profile.json`
- `manifest.json`

These files are **initial templates only** and contain **no personal data**.

---

# ▶️ How to Use

## **1. Import the Skills into Claude**

Load each `SKILL.md` from `/skills/`.

## **2. Initialize your ledgers**

All ledger files are automatically created the moment the Skills are initialized.

You do **not** need to manually copy templates — the system generates clean, schema-compliant ledgers on first use based on Structure DNA v1.0.

If needed, you can still refer to `/example-ledgers/` as reference templates.

## **3. Create your first goal**

Example:

```
Add a new goal: Learn basic Japanese within 8 weeks.

```

Claude will:

- parse → structure → create `G-001`
- update the goal ledger
- schedule if instructed

---

## **4. Ask the scheduler to plan**

```
Schedule all open goals for the next 7 days.

```

---

## **5. Mark tasks as finished**

```
Mark today's study session as done and generate a reflection.

```

The system will:

- update S-entry
- create R-entry
- update manifest

---

## **6. Query your system**

Examples:

```
Show all active goals.
Summarize all progress this week.
Show reflections related to productivity.

```

---

# 🔄 Cognitive Loop

```
Intention → Structure → Scheduling → Action → Reflection → Learning → Re-Goal

```

This creates a **self-updating, continuously learning personal OS**.

---

# 📜 License

MIT License

© Entropy Control Theory (Susan STEM)

---

# 🌱 Philosophy

> Language becomes life when structured and scheduled.
> 
> 
> In M-PPS, language is not only description —
> 
> it becomes **structure**, **action**, **memory**, and **cognition**.
> 

---

# 🙋 Contributing

This repository welcomes:

- New Skills
- Protocol extensions
- Ledger formats
- Test scenarios
- Visualization tools

Each contribution expands the M-PPS structural ecosystem.

---

🧭 Modular Personal Productivity System (M-PPS)

A Minimal, Executable AI-Native Personal Operating System

Built on Structure DNA → M-PPS → LLC → Claude Skills

🧩 Overview

M-PPS (Modular Personal Productivity System) is a lightweight yet complete, executable personal operating system built entirely through language → structure → scheduling.

This repository provides:

Four core structural protocols
Four Claude Skills implementing the M-PPS runtime
Example ledgers (initial JSON templates)
User workflow examples
A minimal, self-consistent cognitive loop

The system transforms an LLM into:

Language Interpreter — intent recognition
Structure Compiler — JSON Structure DNA entries
Scheduler Runtime — executing the lifecycle state machine
Reflection Engine — generating feedback & learning

Every instruction becomes structure.Every structure becomes action.Every action becomes learning.This is the foundation of an AI-Native personal OS.

📐 System Architecture

Language Input (Natural Language)
        ↓
Structure DNA (Unified JSON Schema)
        ↓
M-PPS Modules (Goal, Schedule, Reflection, Profile)
        ↓
Claude Skills (Execution & Dispatch Runtime)
        ↓
Ledger System (goal.json, schedule.json, reflection.json, profile.json)
        ↓
LLC (Language Logic Core: Feedback → Learning)

Structure DNA defines fields, timestamp rules, and state machine.
M-PPS provides the modular life-operations model.
Claude Skills implement scheduling & dispatch.
Ledgers act as the OS memory.
LLC closes the loop into a living cognitive system.

📁 Repository Structure

.
├── protocols/
│   ├── structure-dna/v1.0/spec.md
│   ├── m-pps/v1.0/spec.md
│   ├── profile-generator/v1.1.md
│   └── language-logic-core/v1.0.md
│
├── skills/
│   ├── goal-manager/SKILL.md
│   ├── personal-schedule-manager/SKILL.md
│   ├── reflection-manager/SKILL.md
│   └── ledger-registry/SKILL.md
│
├── example-ledgers/
│   ├── goal.json
│   ├── schedule.json
│   ├── reflection.json
│   ├── profile.json
│   └── manifest.json
│
└── README.md

🔧 Core Protocols (Specifications)

The following four foundational protocols define the M-PPS ecosystem.

Protocol	Description
Structure DNA v1.0	Universal schema: fields, timestamps, lifecycle state machine, dispatch semantics
M-PPS Specification v1.0	Defines the operational modules: Goal, Schedule, Reflection, Profile
Profile Generator v1.1	Personal preferences: energy cycles, time blocks, scheduling constraints
Language Logic Core (LLC) v1.0	The meta-cognitive loop: intention → structure → action → reflection → learning

All Skills and ledgers must align with these specification contracts.

🧩 Core Skills

This repository includes four Claude Skills, which together form a runnable execution loop.

Skill	Module	Responsibility
goal.manager	Goal	Parse intentions → generate G-entries
personal.schedule.manager	Schedule	Convert goals into schedulable S-entries
reflection.manager	Reflection	Capture results, learning, feedback (R-entries)
ledger.registry	Registry	Maintain manifest, verify ledger structure

Skill Summary

1. goal.manager

Understand natural-language intentions
Create structured Goal entries (G-xxx)
Assign tags & semantic anchors
Dispatch items into scheduling when ready

2. personal.schedule.manager

Read open goals
Generate Schedule entries (S-xxx)
Apply temporal semantics
Track state transitions (open → scheduled → in_progress → done)
Trigger reflection upon completion

3. reflection.manager

Generate feedback entries (R-xxx)
Update goal success ratios
Produce summary fields
Close the cognitive loop

4. ledger.registry

Read manifest.json
Validate all ledger files
Assist other Skills in consistent file writes

📘 Example Ledgers (Templates)

All example ledgers are stored in:

/example-ledgers/

They include:

goal.json
schedule.json
reflection.json
profile.json
manifest.json

These files are initial templates only and contain no personal data.

▶️ How to Use

1. Import the Skills into Claude

Load each SKILL.md from /skills/.

2. Initialize your ledgers

All ledger files are automatically created the moment the Skills are initialized.

You do not need to manually copy templates — the system generates clean, schema-compliant ledgers on first use based on Structure DNA v1.0.

If needed, you can still refer to /example-ledgers/ as reference templates.

3. Create your first goal

Example:

Add a new goal: Learn basic Japanese within 8 weeks.

Claude will:

parse → structure → create G-001
update the goal ledger
schedule if instructed

4. Ask the scheduler to plan

Schedule all open goals for the next 7 days.

5. Mark tasks as finished

Mark today's study session as done and generate a reflection.

The system will:

update S-entry
create R-entry
update manifest

6. Query your system

Examples:

Show all active goals.
Summarize all progress this week.
Show reflections related to productivity.

🔄 Cognitive Loop

Intention → Structure → Scheduling → Action → Reflection → Learning → Re-Goal

This creates a self-updating, continuously learning personal OS.

📜 License

MIT License

🌱 Philosophy

Language becomes life when structured and scheduled.

In M-PPS, language is not only description —

it becomes structure, action, memory, and cognition.

🙋 Contributing

This repository welcomes:

New Skills
Protocol extensions
Ledger formats
Test scenarios
Visualization tools

Each contribution expands the M-PPS structural ecosystem.