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

0•

Productivity & Workflow

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

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

01Advanced analysis of derived hexagrams including mirror, polarity, nuclear, and diagonal transformations.

02Integrated journaling that connects specific insights directly to your current project context and directory.

03Scholar-persona interpretation mode using DeepSeek R1 for deep analysis of classical Chinese texts.

040 GitHub stars

05Automated tracking of daily hexagram casts with historical archiving in JSON and JSONL formats.

06Arc Tracking system to identify persistent patterns and returning hexagrams across project lifecycles.

Use Cases

01Mapping the 'Birth Hexagram' of a new software project to track its narrative evolution and long-term trajectory.

02Recording daily casts to observe how specific hexagram patterns manifest in code reviews or architectural decisions.

03Querying historical reading patterns to identify recurring latent obstacles or 'nuclear' drivers in your workflow.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add pro-vi/cc-provide iching

For use in Claude.ai and ChatGPT

Download Skill