tomevault-io Init Config
Manage 10 SDD Framework configuration and instruction files.
Managed Files
| File | Purpose |
|---|---|
.github/copilot-instructions.md |
Pragmatic senior engineer guidelines |
.github/instructions/adrs.instructions.md |
ADR creation and management guidelines |
.github/instructions/envisioning.instructions.md |
Envisioning document guidelines |
.github/instructions/specs.instructions.md |
Feature spec guidelines |
.github/instructions/tasks.instructions.md |
Task list guidelines |
.github/instructions/migration-specs.instructions.md |
Migration spec guidelines |
.github/instructions/migration-tasks.instructions.md |
Migration task guidelines |
.github/instructions/documentation-style.instructions.md |
Markdown formatting rules |
.github/docs/coding-guidelines.md |
Fundamental values, mandatory rules, code style |
.markdownlint.yaml |
Markdown linting configuration |
Important Constraints
NEVER create, copy, or recreate files under
.github/plugins/. The plugin folder is managed externally. Ifsdd-init.shcannot be located via the discovery snippet below, inform the user to install/update the plugin.
Locating sdd-init.sh
The plugin can be installed in several locations (workspace, runtime env vars, ~/.vscode/agent-plugins/..., ~/.copilot/agent-plugins/...). Use the locate-sdd-init.sh helper to resolve the absolute path of sdd-init.sh once, then reuse it in every subsequent command. The discovery snippet:
for h in \
.github/plugins/devsquad/hooks/locate-sdd-init.sh \
"${COPILOT_PLUGIN_ROOT:-}/hooks/locate-sdd-init.sh" \
"${CLAUDE_PLUGIN_ROOT:-}/hooks/locate-sdd-init.sh" \
"$HOME/.vscode/agent-plugins/github.com/microsoft/devsquad-copilot/.github/plugins/devsquad/hooks/locate-sdd-init.sh" \
"$HOME/.copilot/agent-plugins/github.com/microsoft/devsquad-copilot/.github/plugins/devsquad/hooks/locate-sdd-init.sh" \
"$HOME/.copilot/installed-plugins/devsquad-copilot/devsquad/hooks/locate-sdd-init.sh"; do
if [ -n "$h" ] && [ -f "$h" ]; then
SDD_INIT="$("$h" 2>/dev/null || true)"
[ -n "$SDD_INIT" ] && [ -f "$SDD_INIT" ] && { echo "FOUND: $SDD_INIT"; exit 0; }
fi
done
echo "MISSING"
exit 1
Capture the absolute path printed after FOUND: and substitute it for <SDD_INIT> in every command below. Bash variables do not persist across tool calls, so use the literal path string.
Verification Mode
<SDD_INIT> verify
Parse the JSON output. Each entry in config has file, status (up-to-date, outdated, missing), and optionally summary.
Creation Mode
To create or update specific files:
<SDD_INIT> create <target-path>
For bulk operations:
# Create only missing files
<SDD_INIT> create-missing
# Create missing + overwrite outdated
<SDD_INIT> update-all
To show a diff for an outdated file:
<SDD_INIT> diff <target-path>
Source: microsoft/devsquad-copilot — distributed by TomeVault.