aiadev 0.11.0__tar.gz

aiadev-0.11.0/.claude-plugin/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "ai-augmented-developer-marketplace",
+  "description": "Marketplace config for AI-Augmented Developer skill package",
+  "owner": {
+    "name": "alairjt",
+    "email": "alairjt@gmail.com"
+  },
+  "plugins": [
+    {
+      "name": "ai-augmented-developer",
+      "description": "Complete development workflow for AI-augmented full-stack projects: TDD, planning, debugging, Django + React + Celery + LiteLLM patterns, autodev pipeline, and deployment skills.",
+      "version": "1.0.0",
+      "source": "./",
+      "author": {
+        "name": "alairjt",
+        "email": "alairjt@gmail.com"
+      }
+    }
+  ]
+}

aiadev-0.11.0/.claude-plugin/plugin.json

@@ -0,0 +1,15 @@
+{
+  "name": "ai-augmented-developer",
+  "description": "Complete development workflow for AI-augmented full-stack projects: TDD, planning, debugging, Django + React + Celery + LiteLLM patterns, autodev pipeline, and deployment skills.",
+  "version": "1.0.0",
+  "author": {
+    "name": "alairjt",
+    "email": "alairjt@gmail.com"
+  },
+  "homepage": "https://github.com/suportly/ai-augmented-developer",
+  "repository": "https://github.com/suportly/ai-augmented-developer",
+  "license": "MIT",
+  "keywords": ["skills", "tdd", "django", "react", "celery", "litellm", "ai", "autodev", "debugging", "workflows"],
+  "skills": "./skills/",
+  "agents": "./agents/"
+}

aiadev-0.11.0/.codex/INSTALL.md

@@ -0,0 +1,52 @@
+# Installing AI-Augmented Developer for Codex
+
+Enable AI-Augmented Developer skills in Codex via native skill discovery.
+
+## Prerequisites
+
+- Git
+
+## Installation
+
+1. **Clone the repository:**
+
+   ```bash
+   git clone https://github.com/suportly/ai-augmented-developer.git ~/.codex/ai-augmented-developer
+   ```
+
+2. **Create the skills symlink:**
+
+   ```bash
+   mkdir -p ~/.agents/skills
+   ln -s ~/.codex/ai-augmented-developer/skills ~/.agents/skills/ai-augmented-developer
+   ```
+
+   **Windows (PowerShell):**
+
+   ```powershell
+   New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills"
+   cmd /c mklink /J "$env:USERPROFILE\.agents\skills\ai-augmented-developer" "$env:USERPROFILE\.codex\ai-augmented-developer\skills"
+   ```
+
+3. **Restart Codex** to discover the skills.
+
+## Verify
+
+```bash
+ls -la ~/.agents/skills/ai-augmented-developer
+```
+
+You should see a symlink pointing to the skills directory.
+
+## Updating
+
+```bash
+cd ~/.codex/ai-augmented-developer && git pull
+```
+
+## Uninstalling
+
+```bash
+rm ~/.agents/skills/ai-augmented-developer
+rm -rf ~/.codex/ai-augmented-developer
+```

aiadev-0.11.0/.cursor-plugin/plugin.json

@@ -0,0 +1,16 @@
+{
+  "name": "ai-augmented-developer",
+  "displayName": "AI-Augmented Developer",
+  "description": "Complete development workflow for AI-augmented full-stack projects: TDD, planning, debugging, Django + React + Celery + LiteLLM patterns, autodev pipeline, and deployment skills.",
+  "version": "1.0.0",
+  "author": {
+    "name": "alairjt",
+    "email": "alairjt@gmail.com"
+  },
+  "homepage": "https://github.com/suportly/ai-augmented-developer",
+  "repository": "https://github.com/suportly/ai-augmented-developer",
+  "license": "MIT",
+  "keywords": ["skills", "tdd", "django", "react", "celery", "litellm", "ai", "autodev", "debugging", "workflows"],
+  "skills": "./skills/",
+  "agents": "./agents/"
+}

aiadev-0.11.0/.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{py,sh}]
+indent_size = 4
+
+[*.md]
+trim_trailing_whitespace = false
+
+[Makefile]
+indent_style = tab

aiadev-0.11.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,51 @@
+<!-- One concern per PR. If this description grows past a few paragraphs,
+     consider splitting the PR. -->
+
+## Summary
+
+<!-- What is this PR doing, and why? One paragraph. Link the issue. -->
+
+Closes #
+
+## Constitution check
+
+<!-- Tick each applicable article. Every FAIL needs a row in the
+     Complexity tracking section below. See constitution.md. -->
+
+- [ ] I. Spec-first — `specs/<branch>/spec.md` exists and is approved, OR this is a waivable change (typo / formatting / revert / hotfix).
+- [ ] II. Test-first — failing test committed before the implementation commit, OR this is a documented waiver.
+- [ ] III. Simplicity — no new abstraction without a second caller today; no new flag without a named user of the non-default value.
+- [ ] IV. Evidence over claims — test plan below enumerates the commands run.
+- [ ] V. Provider pattern — external dependencies accessed through a provider interface, OR N/A.
+- [ ] VI. Privacy by design — no new plaintext logging of secrets / PII; encrypted fields used for new sensitive data.
+- [ ] VII. Attribution — `CREDITS.md` updated if material was adapted.
+
+## Complexity tracking (waivers)
+
+<!-- Leave empty if no article is FAIL. Otherwise one row per waiver. -->
+
+| Article waived | Reason | Alternatives considered | Reviewer |
+|---|---|---|---|
+| | | | |
+
+## Test plan
+
+<!-- Exact commands run locally and their outcome. One bullet per command.
+     Screenshots/recordings welcome for UI changes. -->
+
+- [ ] `python3 scripts/validate_skills.py` — result: …
+- [ ] `npx markdownlint-cli2 '**/*.md'` — result: …
+- [ ] <project-specific test commands>
+
+## Related skills / templates / artifacts
+
+<!-- If this PR touches a skill, link the produced or consumed artifacts
+     (spec.md, plan.md, tasks.md). If it adds a new skill or template,
+     say which pipeline stage it slots into. -->
+
+-
+
+## Notes for the reviewer
+
+<!-- Anything that is not obvious from the diff: tricky decisions,
+     alternatives rejected, follow-up work deferred to another PR. -->

aiadev-0.11.0/.github/workflows/publish.yml

@@ -0,0 +1,61 @@
+name: publish
+
+# Publishes the aiadev wheel + sdist to PyPI on every GitHub release
+# event, plus on manual dispatch so a failed release can be retried
+# without retagging. Authentication uses the PYPI_API_TOKEN repo secret
+# (scoped API token on pypi.org). See docs/RELEASING.md.
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch: {}
+
+jobs:
+  build:
+    name: build sdist + wheel
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tooling
+        run: pip install --upgrade build
+
+      - name: Sync framework assets into the package
+        run: python scripts/sync_assets.py
+
+      - name: Build sdist + wheel
+        run: python -m build
+
+      - name: Upload built artefacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+
+    # Optional GitHub `pypi` environment; if configured, deployment
+    # protection rules can gate publishes behind an approver.
+    environment:
+      name: pypi
+      url: https://pypi.org/p/aiadev
+
+    steps:
+      - name: Download built artefacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

aiadev-0.11.0/.github/workflows/validate.yml

@@ -0,0 +1,160 @@
+name: validate
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  skills:
+    name: skills frontmatter (aiadev validate)
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+          cache-dependency-path: pyproject.toml
+
+      - name: Install aiadev (editable)
+        run: pip install -e '.[dev]'
+
+      - name: Validate every SKILL.md via the CLI
+        run: aiadev validate
+
+  tests:
+    name: pytest (aiadev unit tests)
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+          cache-dependency-path: pyproject.toml
+
+      - name: Install aiadev (editable, with dev extras)
+        run: pip install -e '.[dev]'
+
+      - name: Configure git for the isolated_framework fixture
+        run: |
+          git config --global user.email "ci@example.com"
+          git config --global user.name "ci"
+
+      - name: Run pytest with coverage
+        run: pytest --cov=src/aiadev --cov-report=term --cov-fail-under=80
+
+  doctor:
+    name: aiadev doctor
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+          cache-dependency-path: pyproject.toml
+
+      - name: Install aiadev (editable)
+        run: pip install -e '.[dev]'
+
+      - name: Run aiadev doctor
+        run: aiadev doctor
+
+  install-e2e:
+    name: install end-to-end
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+          cache-dependency-path: pyproject.toml
+
+      - name: Install aiadev (editable, with dev extras)
+        run: pip install -e '.[dev]'
+
+      - name: Configure git for the isolated_framework fixture
+        run: |
+          git config --global user.email "ci@example.com"
+          git config --global user.name "ci"
+
+      - name: Run install round-trip tests
+        run: pytest tests/test_install_e2e.py -v
+
+  markdown:
+    name: markdownlint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: DavidAnson/markdownlint-cli2-action@v16
+        with:
+          globs: "**/*.md"
+
+  clarifications:
+    name: no lingering [NEEDS CLARIFICATION]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Grep for unresolved clarification markers
+        shell: bash
+        run: |
+          set -euo pipefail
+          # A spec or plan with unresolved [NEEDS CLARIFICATION: ...]
+          # markers is, by Article I of the constitution, not approved.
+          # Allowed inside templates/ (scaffolding) and inside
+          # CONTRIBUTING.md / CHANGELOG.md / skills/ (where they are
+          # documented as a convention, not left unresolved).
+          offenders=$(git grep -n -E '\[NEEDS CLARIFICATION' \
+            -- 'specs/**' \
+            ':(exclude)templates/' \
+            ':(exclude)CONTRIBUTING.md' \
+            ':(exclude)CHANGELOG.md' \
+            ':(exclude)skills/**' || true)
+          if [ -n "$offenders" ]; then
+            echo "Unresolved clarification markers found:" >&2
+            echo "$offenders" >&2
+            exit 1
+          fi
+
+  links:
+    name: link check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: lychee
+        uses: lycheeverse/lychee-action@v2
+        with:
+          args: >-
+            --verbose
+            --no-progress
+            --max-concurrency 4
+            --exclude-path node_modules
+            --exclude-path .venv
+            --exclude-path .claude
+            --exclude-path templates
+            --exclude "^https://github.com/alairjt/ai-augmented-developer"
+            --exclude "^https://github.com/suportly/ai-augmented-developer"
+            --exclude "^https://pypi.org/manage/"
+            './**/*.md'
+          fail: true

aiadev-0.11.0/.gitignore

@@ -0,0 +1,20 @@
+.DS_Store
+*.swp
+*.swo
+.env
+node_modules/
+__pycache__/
+*.egg-info/
+.pytest_cache/
+.coverage
+htmlcov/
+dist/
+build/
+
+# Local IDE/Claude Code state; not framework content
+.claude/
+.venv/
+# Build artefacts populated by scripts/sync_assets.py; the source of
+# truth lives at the repo root and is shipped in the wheel via
+# pyproject.toml package-data + MANIFEST.in.
+src/aiadev/_assets/

aiadev-0.11.0/.markdownlint-cli2.jsonc

@@ -0,0 +1,64 @@
+{
+  // Markdownlint config. Kept lenient on purpose — the point is to catch
+  // genuine mistakes (broken tables, malformed links, duplicate headings),
+  // not to enforce a house style that fights the content of SKILL.md files.
+  "config": {
+    "default": true,
+
+    // Line length: SKILL.md prose often wraps at ~100; don't fight that.
+    "MD013": false,
+
+    // Allow inline HTML (used for collapsible sections and <SUBAGENT-STOP>).
+    "MD033": false,
+
+    // Allow bare URLs inside prose (common in CREDITS / README).
+    "MD034": false,
+
+    // First line does not need to be a top-level heading (skills start
+    // with YAML frontmatter).
+    "MD041": false,
+
+    // Duplicate headings across sibling sections are common in
+    // templates (every article has "Rationale"), allow them.
+    "MD024": { "siblings_only": true },
+
+    // Allow emphasis as a heading (used sparingly).
+    "MD036": false,
+
+    // Trailing punctuation in headings is fine (e.g. "Why?").
+    "MD026": false,
+
+    // Blank-line-around-* rules are stylistic formatters that fight
+    // existing SKILL.md / agent prose. They catch no real defect, so
+    // they are disabled in favour of readability.
+    "MD022": false,
+    "MD031": false,
+    "MD032": false,
+
+    // Emphasis-as-heading patterns already disabled above; also turn
+    // off the "bare URL" and "strong within strong" complaints that
+    // trigger inside code examples.
+    "MD038": false,
+    "MD009": false,
+    "MD010": false,
+    "MD012": false,
+    "MD037": false,
+    "MD047": false,
+
+    // MD040 (fenced code block language) and MD023 (heading indentation)
+    // would require retroactive edits across legacy skills. Disabled —
+    // reviewers still catch missing languages when it matters for
+    // rendering.
+    "MD040": false,
+    "MD023": false
+  },
+  "ignores": [
+    "node_modules/",
+    ".venv/",
+    "venv/",
+    ".claude/",
+    "presets/**/skills/",
+    // Ignore Markdown inside code fences of other Markdown files.
+    "**/CHANGELOG.md.bak"
+  ]
+}

aiadev-0.11.0/.opencode/INSTALL.md

@@ -0,0 +1,55 @@
+# Installing AI-Augmented Developer for OpenCode
+
+## Prerequisites
+
+- [OpenCode](https://opencode.ai) installed
+- Git installed
+
+## Installation Steps
+
+### 1. Clone the Repository
+
+```bash
+git clone https://github.com/suportly/ai-augmented-developer.git ~/.config/opencode/ai-augmented-developer
+```
+
+### 2. Symlink Skills
+
+```bash
+mkdir -p ~/.config/opencode/skills
+rm -rf ~/.config/opencode/skills/ai-augmented-developer
+ln -s ~/.config/opencode/ai-augmented-developer/skills ~/.config/opencode/skills/ai-augmented-developer
+```
+
+### 3. Restart OpenCode
+
+Restart OpenCode. Skills will be available via the native `skill` tool.
+
+Verify by asking: "do you have ai-augmented-developer skills?"
+
+## Usage
+
+### Finding Skills
+
+Use OpenCode's native `skill` tool to list available skills.
+
+### Loading a Skill
+
+Use OpenCode's native `skill` tool, e.g. `ai-augmented-developer/specify`.
+
+### Skill Priority
+
+Project skills (`.opencode/skills/`) > Personal skills > AI-Augmented Developer skills
+
+## Updating
+
+```bash
+cd ~/.config/opencode/ai-augmented-developer && git pull
+```
+
+## Uninstalling
+
+```bash
+rm -rf ~/.config/opencode/skills/ai-augmented-developer
+rm -rf ~/.config/opencode/ai-augmented-developer
+```