# Qi Maintenance

Load on agents that make durable changes to a project's files, so the colocated...

- Repository: https://github.com/haowjy/creative-writing-skills (556 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-10-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add haowjy/creative-writing-skills --skill qi-maintenance -g -a claude-code -y`
Codex: `npx skills add haowjy/creative-writing-skills --skill qi-maintenance -g -a codex -y`
Cursor: `npx skills add haowjy/creative-writing-skills --skill qi-maintenance -g -a cursor -y`
Gemini CLI: `npx skills add haowjy/creative-writing-skills --skill qi-maintenance -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add haowjy/creative-writing-skills`

## Description

Load on agents that make durable changes to a project's files, so the colocated AGENTS.md and .context/ docs stay true for the next cold agent.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Qi Maintenance

Treat the nearest `AGENTS.md` and current-truth `.context/` documents like
comments attached to what they cover: read them before changing it.

As you make a coherent change, keep those documents accurate in the same
change. The gap test: guidance, or missing guidance, that would cause a
cold agent to make a wrong decision there is a gap; a changed path or a
missing `.context/` file is not a gap by itself. Close the gaps before
finishing and leave the rest alone.

Write what a cold agent needs and can't read from the files themselves. When the
implementation diverged from the settled plan, record the divergence and leave
the intent as settled.

Load `/creative-writing-skills:qi-layer` when creating, moving, restructuring, or substantially
rewriting colocated knowledge.

Track deferred work separately: directory-local must-do work goes in the
nearest `.context/TODO`, directory-local nice-to-have work in
`.context/FUTURE`, and cross-cutting or externally visible work in the project
issue tracker. Load `/creative-writing-skills:knowledge-layers` when placement is unclear.
Cross-cutting KB synthesis belongs to `@kb-lead`, after the change settles.