What is aiws-sdd-migrate?

A one-time process for moving an older software-specification workspace into a Git-based layout. Git is a system that records file history and lets you recover earlier versions.

Use it to migrate old specifications with names such as _v3 and folders such as sdd_docs/ into the newer specification and development-file structure.

It replaces versioned filenames and a separate document folder with one organised history, while requiring a plan and reversible commits for safety.

aiws-sdd-migrate — Skill for Claude Code and Codex by grojof

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add grojof/ai-workspace-generator --skill aiws-sdd-migrate

Clone the repo

git clone --depth 1 https://github.com/grojof/ai-workspace-generator

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/grojof/ai-workspace-generator/aiws-sdd-migrate/github.svg)](https://agentmods.dev/skills/grojof/ai-workspace-generator/aiws-sdd-migrate)

Your own site

<a href="https://agentmods.dev/skills/grojof/ai-workspace-generator/aiws-sdd-migrate"><img src="https://agentmods.dev/badge/skills/grojof/ai-workspace-generator/aiws-sdd-migrate/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/grojof/ai-workspace-generator/aiws-sdd-migrate"><img src="https://agentmods.dev/badge/skills/grojof/ai-workspace-generator/aiws-sdd-migrate.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 56 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 689 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00056	$0.00689
Opus 5	$0.00028	$0.00345
Sonnet 5	$0.00011	$0.00138
Haiku 4.5	$0.00006	$0.00069

Measured 11d ago against content hash 9fd6d60b10e1, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

aiws-sdd-migrate scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skill-packs/aiws-sdd-migrate/SKILL.md · 43 lines

How it starts

The opening of the file, as written. The whole thing — 43 lines — stays where its author put it; the contents beside it link to each section on GitHub.

aiws-sdd-migrate — legacy non-Git SDD → unified model (one-off, advanced)

Migrate a workspace built with standalone, pre-Git SDD plugins (no-Git v1) to this generator's unified model: _vN filename versioning → Git, and the parallel sdd_docs/ trail → the single {{paths.development}}/ store. One-time, opt-in, advanced/IT use — not forced on anyone.

Detect (stop if none of these are present)

_vN-suffixed specs (e.g. specs/001-foo_v3.md), a specs/archive/ folder, and/or a sdd_docs/ folder. If the repo already uses {{paths.specs}}/<NNN>-<slug>.md + Git, there is nothing to migrate.

Plan first (no writes)

Require a clean git working tree (commit/stash first) — Git is the safety net. Produce a migration plan and show it; proceed only on explicit confirmation. Do every step as its own reversible commit.

Steps

Specs _vN → Git. Per spec_id, keep the highest-version file as the canonical {{paths.specs}}/<NNN>-<slug>.md (drop the _vN suffix). The version history already lives in §0 Changelog; the old _vN + specs/archive/ copies become Git history — remove the duplicates in the migration commit (recoverable via Git). Preserve each spec's frontmatter status.
sdd_docs/ trail → unified store. The per-skill trail files carry process notes: fold durable decisions into {{paths.status}}/PROJECT-STATE.md and any in-flight context into {{paths.changes}}/<change>/. Then remove sdd_docs/.
Lifecycle. Status is unchanged; from now on aiws-sdd-spec-review drives transitions over Git (no _vN).
Config. Set sdd.schema: reasons (+ appProfile if applicable) in workspace.config.yaml; run ai-workspace sync to project AGENTS.md + skills.

Safety

Never delete anything not already committed to Git. One commit per logical step; each reversible.
A malformed spec stops the migration — surface it, don't migrate a corrupted spec.
Report a summary: N specs migrated, M trail files folded, archive/ + sdd_docs/ removed.

Read the full file on GitHub · 43 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

pack.yaml 171 B

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

11d ago First seen · 43 lines · 56 tokens per session scan A 9fd6d60b10e1

Subscribe to this mod's changes

aiws-sdd-migrate is a skill published in the GitHub repository grojof/ai-workspace-generator (2 stars, last pushed 4d ago), licensed Apache-2.0. It adds 56 tokens to every session and 689 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Git and workflow

prowler-commit

Creates professional git commits following conventional-commits format. Trigger: When creating commits, after completing code changes, when user asks to commit.

prowler-cloud/prowler · 33 tokens

gh-auth-isolation

Safely manage multiple GitHub identities (EMU + personal) in agent workflows.

github/gh-aw · 20 tokens

comet-github

A routing guide for Comet-related GitHub work. It directs requests about pull requests, issues, CI failures, ideas, and fixes to the appropriate review or implementation process.

rpamis/comet · 72 tokens

github-skill

Work with GitHub via the gh CLI — clone repositories, create/list/merge pull requests, create/list issues, and run any other gh command (API calls, workflow runs, releases, repo administration). List operations return parsed JSON.

zeenie-ai/OpenCompany · 51 tokens

changelog-composer

Generates structured changelogs and release notes from git history and PRs, classifying breaking changes, features, fixes, performance, docs. Triggers on: "generate changelog", "write release notes", "what changed since", "prepare release", "release notes for", "diff since tag".

Mathews-Tom/armory · 67 tokens

re0-merge

Review and land an external contribution the way this suite does: gate it against the thesis, land it with the author's credit intact, complete a new skill rather than merging it raw, then approve, credit, and explain before closing. Use when reviewing a pull request, as any collaborator or maintainer, not only the…

LilMGenius/paperthin · 70 tokens