@myszon01/agentic-bundle-claude 0.0.0-stage → 0.1.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,19 @@
+{
+  "name": "agentic-bundle",
+  "owner": {
+    "name": "myszon01"
+  },
+  "description": "A portable agentic harness: shared instructions, skills, commands, subagents and MCP servers.",
+  "plugins": [
+    {
+      "name": "agentic-bundle",
+      "source": {
+        "source": "npm",
+        "package": "@myszon01/agentic-bundle-claude",
+        "version": "0.1.0"
+      },
+      "description": "A portable agentic harness: shared instructions, skills, commands, subagents and MCP servers.",
+      "version": "0.1.0"
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,15 @@
+{
+  "name": "agentic-bundle",
+  "version": "0.1.0",
+  "description": "A portable agentic harness: shared instructions, skills, commands, subagents and MCP servers.",
+  "author": {
+    "name": "myszon01"
+  },
+  "repository": "https://github.com/myszon01/agentic-bundle",
+  "license": "MIT",
+  "keywords": [
+    "harness",
+    "skills",
+    "workflow"
+  ]
+}

package/.mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "fetch": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": [
+        "mcp-server-fetch"
+      ]
+    }
+  }
+}

package/AGENTS.md

@@ -0,0 +1,19 @@
+# Working agreements
+
+These instructions are shared by every coding agent this harness is installed into.
+
+## How to work
+
+- Read the relevant code before changing it; match the surrounding style, naming and comment density.
+- Prefer small, focused changes. Do not refactor unrelated code in the same change.
+- Run the project's own checks (tests, linter, type checker) before declaring work done, and report failures honestly.
+- Ask before destructive or hard-to-reverse actions (deleting data, force-pushing, rewriting history).
+
+## Commits
+
+- Use Conventional Commits (`type(scope): summary`). The `conventional-commits` skill has the details.
+- One logical change per commit; explain *why* in the body when it is not obvious.
+
+## Reviews
+
+- When asked to review, use the `code-review` skill and lead with correctness issues before style.

package/README.md

@@ -1,3 +1,31 @@
-# Temporary Holding Version
+# @myszon01/agentic-bundle-claude
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Claude Code package of agentic-bundle: A portable agentic harness: shared instructions, skills, commands, subagents and MCP servers.
+
+Generated with agentic-bundle from `agentic-bundle@0.1.0` for **Claude Code**.
+
+## Install
+
+Into your user config, without cloning anything:
+
+```bash
+npx -y @myszon01/agentic-bundle install claude --scope user
+```
+
+Or as a Claude Code plugin. This package is a plugin whose marketplace entry installs it from npm:
+
+```bash
+tar -xzf "$(npm pack @myszon01/agentic-bundle-claude | tail -1)"   # unpacks into ./package
+claude plugin marketplace add ./package
+claude plugin install agentic-bundle@agentic-bundle
+```
+
+## Contents
+
+- `.claude-plugin`
+- `.mcp.json`
+- `AGENTS.md`
+- `agents`
+- `commands`
+- `hooks`
+- `skills`

package/agents/researcher.md

@@ -0,0 +1,13 @@
+---
+name: researcher
+description: "Read-only codebase researcher. Use to answer \"where/how is X done?\" questions without modifying files."
+tools: "Read, Grep, Glob, LS"
+model: haiku
+---
+
+You are a read-only research agent. Answer the question you are given by searching and reading the codebase.
+
+- Never modify files or run commands with side effects.
+- Cite every claim with `path:line`.
+- If the answer is uncertain, say what you checked and what is still unknown.
+- Reply with a short answer first, then the supporting evidence.

package/commands/commit.md

@@ -0,0 +1,9 @@
+---
+description: Stage the current work and write a Conventional Commits message
+argument-hint: "[extra context]"
+allowed-tools: "Bash, Read"
+---
+
+Look at `git status` and `git diff`, stage the changes that belong together, and commit them using the conventional-commits skill.
+
+Additional context from the user: $ARGUMENTS

package/commands/review.md

@@ -0,0 +1,9 @@
+---
+description: Review the current changes (or the given target) for bugs and risks
+argument-hint: "[path, branch or PR]"
+allowed-tools: "Read, Grep, Glob, Bash"
+---
+
+Use the code-review skill to review $ARGUMENTS.
+
+If no target was given, review the uncommitted changes plus any commits on the current branch that are not on the default branch.

package/hooks/hooks.json

@@ -0,0 +1,15 @@
+{
+  "description": "Load agentic-bundle instructions into context",
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cat \"${CLAUDE_PLUGIN_ROOT}/AGENTS.md\""
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,23 @@
 {
   "name": "@myszon01/agentic-bundle-claude",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Claude Code package of agentic-bundle: A portable agentic harness: shared instructions, skills, commands, subagents and MCP servers.",
+  "keywords": [
+    "agentic-bundle",
+    "claude",
+    "harness",
+    "skills",
+    "workflow"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "myszon01"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/myszon01/agentic-bundle.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/skills/code-review/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: code-review
+description: Review a diff or set of files for correctness, security and maintainability issues. Use when asked to review code, a pull request, or the current changes.
+---
+
+# Code review
+
+1. Collect the change. If nothing specific was given, run `scripts/changed-files.sh` to list files changed against the default branch, then read the diff.
+2. Review in this order, and stop to report anything severe:
+   1. **Correctness** — logic errors, unhandled edge cases, broken error handling, race conditions.
+   2. **Security** — injection, unsafe deserialization, secrets in code, missing authorization checks.
+   3. **Tests** — is the new behaviour covered? Do existing tests still make sense?
+   4. **Maintainability** — naming, duplication, dead code, unclear abstractions.
+3. For each finding give: file and line, what is wrong, a concrete failure scenario, and a suggested fix.
+4. Finish with a one-line verdict: *ship it*, *ship with nits*, or *needs changes*.
+
+Do not report style nits that a formatter or linter would catch.

package/skills/code-review/scripts/changed-files.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env sh
+# List files changed on the current branch relative to the default branch.
+set -eu
+base=$(git symbolic-ref --quiet --short refs/remotes/origin/HEAD 2>/dev/null || echo origin/main)
+git diff --name-only "$(git merge-base HEAD "$base" 2>/dev/null || echo HEAD)"

package/skills/conventional-commits/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: conventional-commits
+description: Write commit messages that follow the Conventional Commits spec. Use when committing changes, drafting a commit message, or squashing a branch.
+---
+
+# Conventional Commits
+
+Format every commit message as:
+
+```
+<type>(<optional scope>): <imperative summary, max 72 chars>
+
+<optional body: what changed and why, wrapped at 72 chars>
+
+<optional footer: BREAKING CHANGE: ..., Refs: #123>
+```
+
+## Types
+
+| type       | use for                                             |
+|------------|-----------------------------------------------------|
+| `feat`     | a new user-facing capability                        |
+| `fix`      | a bug fix                                           |
+| `docs`     | documentation only                                  |
+| `refactor` | code change that neither fixes a bug nor adds a feature |
+| `perf`     | performance improvement                             |
+| `test`     | adding or fixing tests                              |
+| `build`    | build system or dependencies                        |
+| `ci`       | CI configuration                                    |
+| `chore`    | anything else that does not touch src or tests      |
+
+## Rules
+
+1. Summary in the imperative mood ("add", not "added"), no trailing period.
+2. Mark breaking changes with `!` after the type/scope **and** a `BREAKING CHANGE:` footer.
+3. Inspect the staged diff (`git diff --cached`) before writing the message; describe what it actually does.