Where is my I Ching data stored?

All data, including your cast history and narrative journal, is stored locally in your ~/.claude/ directory, making it accessible across all your different projects while maintaining privacy.

What are 'Project Arcs' in this skill?

Arcs are sequences of hexagrams that connect over days or weeks. The skill tracks returning hexagrams and persistent patterns to reveal the unfolding narrative of a specific project or professional challenge.

How does the I Ching Companion integrate with my code?

The skill treats the hexagram as a 'lens' for your current workspace. It documents which project you were working on during a cast, helping you notice how the hexagram's pattern is already manifesting in your code or decisions.

Does it support traditional Chinese interpretations?

Yes, it includes support for the Lai Zhide framework and can use DeepSeek R1 with specific scholar-persona priming to provide nuanced interpretations based on classical Chinese texts.

I Ching Companion

Name: I Ching Companion
Author: pro-vi

bypro-vi

Productivity & Workflow

Integrates daily I Ching readings and hexagram analysis into your development workflow to provide philosophical context for projects and decisions.

About

The I Ching Companion is a specialized skill for Claude Code that transforms the ancient wisdom of the I Ching into a reflective tool for modern developers. It tracks daily hexagram casts, maintains a historical archive, and generates a narrative journal that links specific readings to your current coding projects and workspace. By analyzing complex relationships between primary and derived hexagrams—including mirror (综卦), polarity (错卦), and nuclear (互卦) patterns—the skill helps you identify 'Project Arcs' and recurring themes, offering a unique lens to observe how patterns manifest in your code, architecture, and professional life.

Key Features

Advanced analysis of derived hexagrams including mirror, polarity, nuclear, and diagonal transformations.
Integrated journaling that connects specific insights directly to your current project context and directory.
Scholar-persona interpretation mode using DeepSeek R1 for deep analysis of classical Chinese texts.
0 GitHub stars
Automated tracking of daily hexagram casts with historical archiving in JSON and JSONL formats.
Arc Tracking system to identify persistent patterns and returning hexagrams across project lifecycles.

Use Cases

Mapping the 'Birth Hexagram' of a new software project to track its narrative evolution and long-term trajectory.
Recording daily casts to observe how specific hexagram patterns manifest in code reviews or architectural decisions.
Querying historical reading patterns to identify recurring latent obstacles or 'nuclear' drivers in your workflow.

About

Key Features

Advanced analysis of derived hexagrams including mirror, polarity, nuclear, and diagonal transformations.
Integrated journaling that connects specific insights directly to your current project context and directory.
Scholar-persona interpretation mode using DeepSeek R1 for deep analysis of classical Chinese texts.
0 GitHub stars
Automated tracking of daily hexagram casts with historical archiving in JSON and JSONL formats.
Arc Tracking system to identify persistent patterns and returning hexagrams across project lifecycles.

Use Cases

Mapping the 'Birth Hexagram' of a new software project to track its narrative evolution and long-term trajectory.
Recording daily casts to observe how specific hexagram patterns manifest in code reviews or architectural decisions.
Querying historical reading patterns to identify recurring latent obstacles or 'nuclear' drivers in your workflow.