restart-life

English | 简体中文

restart-life is a local-first skill pack for structured life and career decisions. It gives Codex and Claude a Chinese-first, evidence-gated workflow for discovery, option comparison, experiments, proof, integration, and private memory updates.

The project is distributed as an npm CLI and as native Codex / Claude plugin metadata. It installs the public 11-skill pack into a target project without copying private runtime data.

Contents

• Why
• Features
• Quick Start
• Skill Pack
• Architecture Contract
• Commands
• Star History
• Development
• Contributing
• Security
• License

Why

Most life-planning prompts collapse into advice too early. restart-life separates evidence from assumptions and forces the agent to route through the right workflow before making durable claims.

The default contract is:

• no usable profile -> discovery first
• serious confusion or pain -> investigation first
• competing directions -> Odyssey-style comparison
• chosen direction -> bounded experiment
• experiment results -> proof review
• durable memory change -> memory-write gate

Features

• One-command install: npx restart-life@latest init --dir <project>.
• 11 public skills: front door, DCAP, ICAP, roundtable, and memory-write workflows.
• Codex and Claude ready: installs to .agents/skills and/or .claude/skills; includes .codex-plugin and .claude-plugin manifests.
• Private runtime boundary: user data lives under ~/.restart-life, never inside the npm skill package.
• Machine-checkable gates: profile, lifecycle, JSONL, runtime, panel, and skill-pack validators.
• Single-file HTML panel: renders a private local progress view without a server.
• Project-readable projections: --project-output writes RESTART-LIFE.md, restart-life-panel.html, and restart-life/summary.md into the active project as Generated projection files that are safe to delete and regenerate.
• Safe updates: --force overwrites only restart-life managed files and leaves unrelated project content alone.

Quick Start

Install the full skill pack into a project:

npx --yes restart-life@latest init --dir /path/to/project

Install only one host surface:

npx --yes restart-life@latest init --dir /path/to/project --platform codex
npx --yes restart-life@latest init --dir /path/to/project --platform claude

Check the installation:

npx --yes restart-life@latest doctor --dir /path/to/project

Render the local panel:

npx --yes restart-life@latest panel --runtime ~/.restart-life

Render the project-readable surface:

npx --yes restart-life@latest panel --dir /path/to/project --runtime ~/.restart-life --project-output

Use --force only when you intentionally want to overwrite files inside restart-life managed skill directories. It does not delete or overwrite unrelated .agents or .claude content.

Skill Pack

The public installer copies only the skills listed in .agents/skills/restart-life-suite.json:

Skill	Role
restart-life	Front door router; never writes durable user data directly.
life-discover	Builds the first usable profile from evidence.
life-roadmap	Maintains roadmap and backlog only after a usable profile exists.
life-investigate	Freezes the real problem before advice.
life-principle	Turns investigated cases into reusable personal principles.
life-choose	Compares paths with Odyssey-style decision briefs.
life-act	Converts a decision into a 7-day or 30-day experiment.
life-prove	Reviews experiment evidence and decides what is reliable.
life-integrate	Updates durable profile, compass, roadmap, and backlog.
life-roundtable	Runs optional blind-spot review before acting or integrating.
memory-write-gate	Protects durable memory writes with explicit evidence.

Developer-only skills such as npm-release are not part of the public package or init install list.

Architecture Contract

restart-life keeps four worlds separate:

World	Path	Contract
Source package	.agents/skills	Public skill source and suite metadata.
Installed skills	target .agents/skills and/or .claude/skills	Copied skill pack controlled by the installer registry.
Private runtime	~/.restart-life	Durable user profile, cycle artifacts, evidence, roadmap, and raw memory truth.
Project-readable surface	target RESTART-LIFE.md, restart-life-panel.html, restart-life/	Generated projection files for quick operation; safe to delete/regenerate and ignored by default.

The current suite contract is deliberately file-based and auditable:

• restart-life-suite.json lists the 11 visible skills and panel/evolution metadata.
• Every visible SKILL.md carries entry checks, read order, output formats, quality gates, reroutes, and forbidden behavior.
• Every skill owns a local references/guide.md, output template under assets/, and scripts/check-handoff.mjs.
• sourceLineage plus the ## 思想来源 guide section preserves the intended theory/person-frame before execution.
• validate:profile checks profile.json, discovery-map.md, and ledger-backed evidence references.
• validate:life-cycle checks DCAP and ICAP artifacts before they become durable truth.
• render:panel creates a read-only single-file HTML view from private runtime data; the panel is not a server and not a source of truth.
• panel --project-output writes the project-readable surface using templates/project-output/ so material Markdown sections do not drift across agent conversations.
• evolve:skills creates Darwin-style skill evolution packets under devflow/skill-evolution/.

Commands

node bin/restart-life-cli.js init --dir /path/to/project
node bin/restart-life-cli.js doctor --dir /path/to/project
node bin/restart-life-cli.js panel --runtime ~/.restart-life
node bin/restart-life-cli.js panel --dir /path/to/project --runtime ~/.restart-life --project-output

npm test
npm run validate:profile
npm run validate:life-cycle
npm run validate:skill-pack
npm run validate:runtime
npm run validate:cycles
npm run validate:jsonl
npm run validate:panel
npm run sync:check
npm run doctor

npm run render:panel -- --runtime ~/.restart-life --out ~/.restart-life/panel/restart-life-panel.html
npm run render:panel -- --repo /path/to/project --runtime ~/.restart-life --project-output
npm run evolve:skills -- --write
npm run validate:skill-evolution

Star History

Development

Requirements:

• Node.js 20 or newer
• npm
• Git

Local setup:

git clone https://github.com/Dimon94/restart-life.git
cd restart-life
npm test

Before sending changes, run the smallest relevant validation plus npm test. For installer or release changes, also run:

npm publish --dry-run --access public
tmpdir=$(mktemp -d /tmp/restart-life-npx-XXXXXX)
target=$(mktemp -d /tmp/restart-life-target-XXXXXX)
cd "$tmpdir"
npx --yes restart-life@latest init --dir "$target" --platform codex

Roadmap

• Broaden the native Codex / Claude plugin path as those ecosystems stabilize.
• Improve the private HTML panel without turning it into a hosted dashboard.
• Add more lifecycle fixtures for high-pressure decision scenarios.
• Keep the public skill pack small and exclude maintainer-only workflows from user installs.

Contributing

Contributions are welcome. Start with CONTRIBUTING.md.

Good first contributions usually improve:

• lifecycle fixtures and validation coverage
• docs clarity in English or Chinese
• installer safety around managed files
• skill handoff checks

This project uses Conventional Commits. Keep changes focused and avoid mixing feature, test, docs, and release work in one commit.

Security

Do not open public issues for private runtime data, token leaks, or sensitive personal information. Follow SECURITY.md.

restart-life is a local decision-support harness. It is not medical, legal, financial, or mental-health advice.

License

Released under the MIT License.