niko/ai-superpower
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
808ae1ad15
ai-superpower/.ai/skills/root-skill/SKILL.md

3.0 KiB
Raw Blame History

name description category
root-skill The absolute master configuration and state machine for the AI. This is the entry point that governs how the AI operates, changes states, and loads other skills. meta

🏷️ Category: Meta-Skill | ⚙️ Applies to: Global AI State Machine & Workflow

Root Skill (The Master State Machine)

⚡ ACKNOWLEDGMENT REQUIRED

YOU MUST start EVERY response with this acknowledgment on the FIRST LINE: ✅ root-skill READ — git add/commit/push FORBIDDEN without explicit permission

🚦 STATE MACHINE RULES (THINK BEFORE ACT)

To prevent premature execution, you operate as a State Machine. You must explicitly declare your state immediately after the acknowledgment line.

STATE: PLAN (Default state for analysis and planning)

  • FIRST ACTION: Ensure .ai/skills/core-principles/SKILL.md is loaded.
  • FORBIDDEN: Do NOT use replace_string_in_file, create_file, or terminal commands that modify state (git add, writing files).
  • ALLOWED: read_file, file_search, grep_search, read-only terminal (ls, cat), and proposing plans.
  • Propose the strategy in bullet points only. Do NOT output concrete implementation code blocks. Stop and ask for approval.

STATE: IMPLEMENTATION (Only when user explicitly approves/commands)

  • CRITICAL PRE-EXECUTION: Before any file edits, mechanically read_file the relevant skill files (e.g., clean-code, helm).
  • ACTIVE SKILL ECHO: Immediately after reading skills, output a section ### Active Skills: summarizing the 2-3 most critical rules.
  • ALLOWED: You may use file modification tools and generate concrete code.
  • RETURN TO PLAN: Once execution is finished, your VERY NEXT response MUST transition back to STATE: PLAN.

🚫 GIT HARD RULES (Reference)

See complete Git rules: .ai/skills/git/SKILL.md

📚 The Modular Skills Architecture

You must load specialized instructions from .ai/skills/<name>/SKILL.md when relevant:

  • GitOps & Infra: iac, helm, kubernetes-access
  • Code Quality: clean-code, clean-architecture
  • Workflow: git, write-skill, analysis
  • Meta: core-principles, readme, docs (Use file search/grep if you need a specific skill that isn't listed here).

🌐 Language Rule

ALL documentation files must be written in English. You may communicate in the chat in the user's preferred language (Finnish).

Resource Access Rules

When you need to read a skill or a file listed in .ai/skill-list.txt, construct the URL using the following logic:

  1. Base URL: https://gitea.nikos-dev.keskikuja.site/niko/ai-superpower/src/branch/main/

  2. File Path: Combine the Base URL with the relative path of the skill

  1. Raw Access (Optional): If direct parsing fails, try replacing /src/branch/main/ with /raw/branch/main/ to get the plain text version.