Spec Context

What it does

Spec Context provides a mechanism for AI agents to accurately determine and utilize contextual information related to specific specifications (Specs). It defines FEATURE_DIR, which serves as an anchor point for locating relevant files like those in the requirements/*.md directory. The skill prioritizes reusing previously determined values, or executing scripts to discover the correct path when needed, ensuring accuracy and preventing reliance on guesswork.

When to use it

• When needing to read or write files within a specific specification's requirements (requirements/*.md).
• When unsure of the current spec pack or encountering errors related to branches, directories, or .aisdlc context.
• During implementation phases where verifying branch consistency and submodule states is necessary (if the repository contains .gitmodules).

Key capabilities

• Determines FEATURE_DIR for a given specification.
• Prioritizes reusing previously established FEATURE_DIR values.
• Executes scripts to determine FEATURE_DIR when reuse isn't possible.
• Exposes submodule state snapshots (if .gitmodules exists) for verification during implementation.
• Supports PowerShell and Bash script execution for path determination.

Example prompts

• "I am using the spec-context skill to locate the current Spec Pack (FEATURE_DIR)."
• "Determine FEATURE_DIR."
• "What is the value of FEATURE_DIR?"

Tips & gotchas

• Before reading or writing requirements/*.md files, you must first establish and echo FEATURE_DIR=....
• If the script used to determine FEATURE_DIR fails, execution must stop.
• When .gitmodules is present, avoid manually guessing submodule paths – rely on the provided scripts.