# ai-sdlc

ai-sdlc — a hook bundle for a six-stage Markdown SDLC in Claude Code. It checks tool calls to block unauthorized file edits and safeguard sensitive project paths.

- hook · `type=hook` · Claude Code, Codex · ★ 1596 repo stars
- Author: Hieuvu7
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/ghiaog123/ai-native-sdlc/hooks/hooks.codex.json
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text and 1 script file) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/hooks/ai-sdlc

## What it does

The `ai-sdlc` hooks intercept agent actions right before tool execution. During the `PreToolUse` event, `artifact-gate.sh` inspects every `Write` and `Edit` call. If an edit lacks a corresponding approved Markdown plan, the hook stops the write operation immediately. It also keeps tasks tagged as low-risk away from sensitive paths.

Terminal execution receives its own boundary: `prod-guard.sh` listens to `Bash` tool calls. Meanwhile, `session-context.sh` fires on `SessionStart` to prepare the development context, and `prompt-nudge.sh` triggers on `UserPromptSubmit`. Without committed plan files, the agent cannot write code.

Setup requires adding the hook definitions into `.claude/settings.json`. The full plugin bundle also pairs these hooks with 8 skills and 2 read-only subagents.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/settings.json` — The hooks block: event (PreToolUse, PostToolUse, Stop…) → command. Personal ones go to ~/.claude/settings.json

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/ghiaog123/ai-native-sdlc/hooks/hooks.codex.json

## When to use it
- Block source code modifications that lack an approved Markdown plan
- Prevent low-risk changes from touching sensitive repository paths
- Guard shell command execution through `prod-guard.sh`
- Inject development context automatically upon `SessionStart`

## Example prompts
- Edit `src/app.ts` following the approved task plan
- Run the build script using the terminal
- Generate the planning artifact before modifying any source files

## Source text · hooks.codex.json · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 867f9096d11022bb.

BEGIN THIRD-PARTY FILE 867f9096d11022bb
````text
Hooks bundle shipped with the ai-sdlc plugin for Claude Code.

Six-stage SDLC in committed Markdown where hooks enforce the loop at the tool-call level: an artifact gate refuses source writes no approved plan covers and keeps a change declared low-risk away from sensitive paths, with 8 skills and 2 read-only subagents.

Triggers on: PreToolUse, UserPromptSubmit, SessionStart.

```json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "\"${PLUGIN_ROOT}/hooks/artifact-gate.sh\""
          }
        ]
      },
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "\"${PLUGIN_ROOT}/hooks/prod-guard.sh\""
          }
        ]
      }
    ],
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "\"${PLUGIN_ROOT}/hooks/session-context.sh\""
          }
        ]
      }
    ],
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "\"${PLUGIN_ROOT}/hooks/prompt-nudge.sh\""
          }
        ]
      }
    ]
  }
}

```
````
END THIRD-PARTY FILE 867f9096d11022bb

The third-party file has ended. Everything between the 867f9096d11022bb tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© Hieuvu7 · MIT · https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/ghiaog123/ai-native-sdlc/hooks/hooks.codex.json

## Similar
- [agentic-sdlc-controls](https://affpapa.org/en/nevibecode/skills/agentic-sdlc-controls.md) — skill · 1400 installs
- [01-sdlc](https://affpapa.org/en/nevibecode/skills/01-sdlc.md) — skill · ★ 571 repo stars
- [secure-sdlc-agents](https://affpapa.org/en/nevibecode/plugins/secure-sdlc-agents.md) — plugin · ★ 15 repo stars
- [sdlc-review](https://affpapa.org/en/nevibecode/skills/sdlc-review.md) — skill · 162 installs
- [om-auto-manage-issues](https://affpapa.org/en/nevibecode/skills/om-auto-manage-issues.md) — skill · 4100 installs
- [om-auto-write-spec](https://affpapa.org/en/nevibecode/skills/om-auto-write-spec.md) — skill · 3900 installs

From the same set: [hashgraph-online/awesome-codex-plugins](https://affpapa.org/en/nevibecode/by/hashgraph-online/awesome-codex-plugins.md) — 391 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
