ai-factory 2.2.2 → 2.4.0

package/skills/aif-ci/SKILL.md

@@ -34,6 +34,26 @@ Read .ai-factory/DESCRIPTION.md
 
 Store project context for later steps. If absent, Step 2 detects everything.
 
+**Read `.ai-factory/skill-context/aif-ci/SKILL.md`** — MANDATORY if the file exists.
+
+This file contains project-specific rules accumulated by `/aif-evolve` from patches,
+codebase conventions, and tech-stack analysis. These rules are tailored to the current project.
+
+**How to apply skill-context rules:**
+- Treat them as **project-level overrides** for this skill's general instructions
+- When a skill-context rule conflicts with a general rule written in this SKILL.md,
+  **the skill-context rule wins** (more specific context takes priority — same principle as nested CLAUDE.md files)
+- When there is no conflict, apply both: general rules from SKILL.md + project rules from skill-context
+- Do NOT ignore skill-context rules even if they seem to contradict this skill's defaults —
+  they exist because the project's experience proved the default insufficient
+- **CRITICAL:** skill-context rules apply to ALL outputs of this skill — including generated
+  CI workflow files and audit reports. Templates in this skill are **base structures**. If a
+  skill-context rule says "CI MUST include step X" or "workflow MUST have job Y" — you MUST augment
+  the templates accordingly. Generating CI config that violates skill-context rules is a bug.
+
+**Enforcement:** After generating any output artifact, verify it against all skill-context rules.
+If any rule is violated — fix the output before presenting it to the user.
+
 ---
 
 ## Step 1: Detect Existing CI & Determine Mode

package/skills/aif-commit/SKILL.md

@@ -2,8 +2,8 @@
 name: aif-commit
 description: Create conventional commit messages by analyzing staged changes. Generates semantic commit messages following the Conventional Commits specification. Use when user says "commit", "save changes", or "create commit".
 argument-hint: "[scope or context]"
-allowed-tools: Bash(git *)
-disable-model-invocation: true
+allowed-tools: Read Bash(git *) AskUserQuestion Questions
+disable-model-invocation: false
 ---
 
 # Conventional Commit Generator
@@ -12,12 +12,38 @@ Generate commit messages following the [Conventional Commits](https://www.conven
 
 ## Workflow
 
+**Read `.ai-factory/skill-context/aif-commit/SKILL.md`** — MANDATORY if the file exists.
+
+This file contains project-specific rules accumulated by `/aif-evolve` from patches,
+codebase conventions, and tech-stack analysis. These rules are tailored to the current project.
+
+**How to apply skill-context rules:**
+- Treat them as **project-level overrides** for this skill's general instructions
+- When a skill-context rule conflicts with a general rule written in this SKILL.md,
+  **the skill-context rule wins** (more specific context takes priority — same principle as nested CLAUDE.md files)
+- When there is no conflict, apply both: general rules from SKILL.md + project rules from skill-context
+- Do NOT ignore skill-context rules even if they seem to contradict this skill's defaults —
+  they exist because the project's experience proved the default insufficient
+- **CRITICAL:** skill-context rules apply to ALL outputs of this skill — including the commit
+  message format and conventions. If a skill-context rule says "commits MUST follow format X"
+  or "message MUST include Y" — you MUST comply. Generating a commit message that violates
+  skill-context rules is a bug.
+
+**Enforcement:** After generating any output artifact, verify it against all skill-context rules.
+If any rule is violated — fix the output before presenting it to the user.
+
 1. **Analyze Changes**
    - Run `git status` to see staged files
    - Run `git diff --cached` to see staged changes
    - If nothing staged, show warning and suggest staging
 
-2. **Determine Commit Type**
+2. **Run Context Gates (Read-Only)**
+   - Check `.ai-factory/ARCHITECTURE.md` and `.ai-factory/DESCRIPTION.md` (if present) to catch obvious scope/boundary drift
+   - Check `.ai-factory/RULES.md` and `.ai-factory/ROADMAP.md` (if present) to catch rule and milestone alignment issues
+   - Missing optional files (`ROADMAP.md`, `RULES.md`) are `WARN`, not blockers
+   - Never modify context artifacts from this command
+
+3. **Determine Commit Type**
    - `feat`: New feature
    - `fix`: Bug fix
    - `docs`: Documentation only
@@ -29,12 +55,12 @@ Generate commit messages following the [Conventional Commits](https://www.conven
    - `ci`: CI configuration
    - `chore`: Maintenance tasks
 
-3. **Identify Scope**
+4. **Identify Scope**
    - From file paths (e.g., `src/auth/` → `auth`)
    - From argument if provided
    - Optional - omit if changes span multiple areas
 
-4. **Generate Message**
+5. **Generate Message**
    - Keep subject line under 72 characters
    - Use imperative mood ("add" not "added")
    - Don't capitalize first letter after type
@@ -80,16 +106,18 @@ When invoked:
 
 1. Check for staged changes
 2. Analyze the diff content
-3. Propose a commit message
-4. Ask for confirmation or modifications
-5. Execute `git commit` with the message
-6. After a successful commit, offer to push:
+3. Run read-only context gates and summarize findings as `WARN`/`ERROR`
+4. If commit type is `feat`/`fix`/`perf` and roadmap exists, check milestone linkage; if missing, warn and suggest adding linkage in commit body/footer
+5. Propose a commit message
+6. Ask for confirmation or modifications
+7. Execute `git commit` with the message
+8. After a successful commit, offer to push:
    - Show branch/ahead status: `git status -sb`
    - If the branch has no upstream, use: `git push -u origin <branch>`
    - Otherwise: `git push`
    - User choice:
-     - [ ] Push now
-     - [ ] Skip push
+      - [ ] Push now
+      - [ ] Skip push
 
 If argument provided (e.g., `/aif-commit auth`):
 - Use it as the scope
@@ -99,10 +127,12 @@ If argument provided (e.g., `/aif-commit auth`):
 
 - Never commit secrets or credentials
 - Review large diffs carefully before committing
+- `/aif-commit` has no implicit strict mode — context gates are warning-first unless user explicitly requests blocking behavior
+- Treat `.ai-factory/ARCHITECTURE.md`, `.ai-factory/ROADMAP.md`, `.ai-factory/RULES.md`, and `.ai-factory/DESCRIPTION.md` as read-only context in this command
 - If staged changes contain unrelated work (e.g., a feature + a bugfix, or changes to independent modules), suggest splitting into separate commits:
   1. Show which files/hunks belong to which commit
   2. Ask for confirmation
   3. Unstage all: `git reset HEAD`
   4. Stage and commit each group separately using `git add <files>` + `git commit`
   5. Offer to push only after all commits are done
-- Add Co-Authored-By for pair programming if mentioned
+- NEVER add `Co-Authored-By` or any other trailer attributing authorship to the AI. Commits must not contain AI co-author lines

package/skills/aif-dockerize/SKILL.md

@@ -7,7 +7,7 @@ description: >-
   "containerize", or "setup docker".
 argument-hint: "[--audit]"
 allowed-tools: Read Edit Glob Grep Write Bash(git *) Bash(docker *) AskUserQuestion Questions WebSearch WebFetch
-disable-model-invocation: true
+disable-model-invocation: false
 metadata:
   author: AI Factory
   version: "1.0"
@@ -38,6 +38,27 @@ Read .ai-factory/DESCRIPTION.md
 
 Store project context for later steps. If absent, Step 2 detects everything.
 
+**Read `.ai-factory/skill-context/aif-dockerize/SKILL.md`** — MANDATORY if the file exists.
+
+This file contains project-specific rules accumulated by `/aif-evolve` from patches,
+codebase conventions, and tech-stack analysis. These rules are tailored to the current project.
+
+**How to apply skill-context rules:**
+- Treat them as **project-level overrides** for this skill's general instructions
+- When a skill-context rule conflicts with a general rule written in this SKILL.md,
+  **the skill-context rule wins** (more specific context takes priority — same principle as nested CLAUDE.md files)
+- When there is no conflict, apply both: general rules from SKILL.md + project rules from skill-context
+- Do NOT ignore skill-context rules even if they seem to contradict this skill's defaults —
+  they exist because the project's experience proved the default insufficient
+- **CRITICAL:** skill-context rules apply to ALL outputs of this skill — including Dockerfile,
+  compose files, .dockerignore, and deploy scripts. Templates in this skill are **base structures**.
+  If a skill-context rule says "Dockerfile MUST include X" or "compose MUST have service Y" —
+  you MUST augment the templates accordingly. Generating Docker config that violates skill-context
+  rules is a bug.
+
+**Enforcement:** After generating any output artifact, verify it against all skill-context rules.
+If any rule is violated — fix the output before presenting it to the user.
+
 ---
 
 ## Step 1: Detect Existing Docker Files & Determine Mode

package/skills/aif-docs/SKILL.md

@@ -3,7 +3,7 @@ name: aif-docs
 description: Generate and maintain project documentation. Creates a lean README as a landing page with detailed docs/ directory split by topic. Use when user says "create docs", "write documentation", "update docs", "generate readme", or "document project".
 argument-hint: "[--web]"
 allowed-tools: Read Write Edit Glob Grep Bash(mkdir, npx, python) AskUserQuestion Questions WebFetch WebSearch
-disable-model-invocation: true
+disable-model-invocation: false
 metadata:
   author: AI Factory
   version: "1.0"
@@ -38,6 +38,27 @@ Generate, maintain, and improve project documentation following a landing-page R
 - Look for existing docs, comments, API endpoints, CLI commands
 - Check for existing README.md and docs/ directory
 
+**Read `.ai-factory/skill-context/aif-docs/SKILL.md`** — MANDATORY if the file exists.
+
+This file contains project-specific rules accumulated by `/aif-evolve` from patches,
+codebase conventions, and tech-stack analysis. These rules are tailored to the current project.
+
+**How to apply skill-context rules:**
+- Treat them as **project-level overrides** for this skill's general instructions
+- When a skill-context rule conflicts with a general rule written in this SKILL.md,
+  **the skill-context rule wins** (more specific context takes priority — same principle as nested CLAUDE.md files)
+- When there is no conflict, apply both: general rules from SKILL.md + project rules from skill-context
+- Do NOT ignore skill-context rules even if they seem to contradict this skill's defaults —
+  they exist because the project's experience proved the default insufficient
+- **CRITICAL:** skill-context rules apply to ALL outputs of this skill — including README.md,
+  documentation pages, and their templates. The templates in this SKILL.md are **base structures**.
+  If a skill-context rule says "docs MUST include X" or "README MUST have section Y" — you MUST
+  augment the templates accordingly. Generating documentation that violates skill-context rules
+  is a bug.
+
+**Enforcement:** After generating any output artifact, verify it against all skill-context rules.
+If any rule is violated — fix the output before presenting it to the user.
+
 **Scan for scattered markdown files in project root:**
 
 Use `Glob` to find all `*.md` files in the project root (exclude `node_modules/`, `.ai-factory/`, agent dirs):
@@ -496,3 +517,4 @@ Options:
 4. **Use the project's language** — if project README is in Russian, write docs in Russian
 5. **Preserve existing badges/logos** — don't remove them during restructuring
 6. **Add to .gitignore** if generating HTML: add `docs-html/` to .gitignore
+7. **Ownership boundary** — this command owns documentation artifacts (`README.md`, `docs/*`, and the Documentation section in `AGENTS.md`), not `.ai-factory/ROADMAP.md`, `.ai-factory/RULES.md`, or `.ai-factory/RESEARCH.md`