Source of Truth for Editing SKILL.md in the i-have-adhd Repository

The canonical source of truth for editing SKILL.md is the file skills/i-have-adhd/SKILL.md in the repository root, which must be manually synchronized with the mirror copy at .cursor/skills/i-have-adhd/SKILL.md after every modification.

The ayghri/i-have-adhd project maintains ADHD-friendly response guidelines through a structured skill system documented in AGENTS.md. When updating these guidelines, contributors must edit the canonical skill file to ensure the 10 ADHD-friendly response rules remain consistent across both the repository documentation and the Cursor IDE runtime.

Canonical Skill File Location

The definitive source of truth for the ADHD skill rules is skills/i-have-adhd/SKILL.md. This file contains the authoritative implementation of the guidelines that govern how responses should be structured for ADHD accessibility.

AGENTS.md Documentation Reference

According to the source code in AGENTS.md at line 29, the project explicitly designates skills/i-have-adhd/SKILL.md as the canonical location. The documentation states that this path serves as the master copy, preventing ambiguity about which file to edit when modifying response behavior.

Mirror File Synchronization Requirements

The Cursor runtime environment requires a duplicate of the skill file located at .cursor/skills/i-have-adhd/SKILL.md. This mirror is not a secondary source of truth but a runtime dependency that must remain byte-for-byte identical to the canonical file.

Failure to update both files creates drift between the documented rules and the active runtime behavior. Every change set must include modifications to both paths to maintain repository integrity.

How to Edit the ADHD Skill Rules

When updating the skill rules, adhere to this workflow to maintain synchronization between the source of truth and its runtime mirror.

Step 1: Branch and Edit the Canonical File

Create a feature branch and open the canonical skill file in your preferred editor.

git checkout -b update-adhd-skill
code skills/i-have-adhd/SKILL.md

Modify the rules as needed within skills/i-have-adhd/SKILL.md.

Step 2: Synchronize the Mirror

Copy the updated canonical file to the Cursor runtime location immediately after saving.

cp skills/i-have-adhd/SKILL.md .cursor/skills/i-have-adhd/SKILL.md

Step 3: Verify File Integrity

Confirm both files are identical using diff before staging.

diff -u skills/i-have-adhd/SKILL.md .cursor/skills/i-have-adhd/SKILL.md || echo "Mirror out of sync!"

Step 4: Commit Both Files

Stage and commit both paths to ensure atomic updates.

git add skills/i-have-adhd/SKILL.md .cursor/skills/i-have-adhd/SKILL.md
git commit -m "Update ADHD skill rules in canonical and mirror"
git push origin update-adhd-skill

Summary

• The source of truth for editing SKILL.md is exclusively skills/i-have-adhd/SKILL.md at the repository root.
• The mirror file at .cursor/skills/i-have-adhd/SKILL.md must be manually synchronized with every canonical edit.
• The AGENTS.md file at line 29 documents this relationship and explicitly designates the canonical path.
• Always verify synchronization using diff before committing changes to prevent runtime drift between the documented rules and Cursor runtime behavior.

Frequently Asked Questions

What is the source of truth for editing SKILL.md in the i-have-adhd repository?

The source of truth is the file skills/i-have-adhd/SKILL.md located in the repository root. This file contains the master copy of the 10 ADHD-friendly response rules, as explicitly designated in AGENTS.md at line 29. All edits must begin here rather than in the .cursor/ directory.

Do I need to manually sync the mirror file after editing SKILL.md?

Yes, you must manually copy skills/i-have-adhd/SKILL.md to .cursor/skills/i-have-adhd/SKILL.md after every edit. The repository does not implement automated synchronization hooks, so failing to update both files results in the Cursor runtime using outdated rules while the repository shows newer documentation.

What happens if I only edit the .cursor/skills/i-have-adhd/SKILL.md file?

Editing only the mirror file violates the repository architecture defined in AGENTS.md. The canonical file at skills/i-have-adhd/SKILL.md would remain unchanged, creating a discrepancy where the documented source of truth contradicts the runtime behavior. Always edit the canonical file first, then sync to the mirror.

How can I verify that both SKILL.md files are synchronized?

Use the diff command to compare the canonical and mirror files: diff -u skills/i-have-adhd/SKILL.md .cursor/skills/i-have-adhd/SKILL.md. If the files are identical, the command produces no output. Any output indicates the mirror is out of sync and needs updating before you commit your changes.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}