@yottagraph-app/aether-instructions

Agent commands and skills for Aether development (used by Cursor and Claude Code).

The core Aether guidance (architecture, data, UI, agents, MCP servers, deployment, etc.) ships as the aether skill under skills/aether/, with a SKILL.md entry point that indexes the topic files.

Usage

This package is automatically downloaded and extracted during Aether project initialization (init-project.js). You don't need to install it directly.

Files install under .agents/. .cursor and .claude are whole-directory symlinks to .agents/, and .mcp.json at the repo root is a symlink to .agents/mcp.json, so Cursor and Claude Code read the same files.

Updating Instructions

To update to the latest version:

/update_instructions

This command will:

1. Download the latest version of this package
2. Replace files in .agents/ that are listed in .agents/.aether-instructions-manifest
3. Remove the deprecated .agents/rules/ directory if present (rules were replaced by the aether skill)
4. Extract fresh files from the package
5. Commit the changes

File Naming Convention

Package files keep their original names under .agents/commands/ and .agents/skills/. Which paths are owned by the package is recorded in .agents/.aether-instructions-manifest. Only those paths are overwritten on update; other files under .agents/ are not touched by the updater.

Customizing Commands or Skill Topics

To customize something that ships with the package:

1. Copy it to a new filename (a path not listed in the manifest)
2. Make your changes to the copy
3. Your copy won't be replaced when you run /update_instructions

For Maintainers

This package is built from aether-dev sources. Publishing runs in CI via .github/workflows/publish-instructions.yml (see docs/CI_OPS.md in aether-dev).

To re-run locally without CI (e.g. debugging):

bash scripts/publish-instructions.sh --bump patch --publish