Skip to content

Latest commit

 

History

History
99 lines (65 loc) · 2.84 KB

INSTALL.md

File metadata and controls

99 lines (65 loc) · 2.84 KB

forge-core

Module-building skills for the forge ecosystem. Teaches AI coding tools to create skills, scaffold agents, and architect modules.

This file follows the install.md standard — structured instructions for AI agents to execute autonomously. Human readers: see README.md for conventional documentation.

I want you to install forge-core for me. Execute all the steps below autonomously.

OBJECTIVE

Deploy forge-core skills, agents, and rules to all AI providers via Makefile.

DONE WHEN

  • make validate passes
  • ls ~/.claude/skills/BuildSkill/SKILL.md confirms skill deployment
  • git config core.hooksPath returns .githooks
  • ~/.claude/settings.json contains the hooks block with forge-core hook commands

Prerequisites

  • Claude Code (or another AI provider CLI)
  • Rust toolchain (rustup + cargo) — rustup.rs
  • forge-cli (cargo install from source, see step below)
  • gitleaks (brew install gitleaks) — shared by SecretScan, VersionControl, and ForensicAgent

Without Rust: copy skills/, agents/, rules/ into the provider config directory (e.g., ~/.claude/) directly.

TODO

  • Install prerequisites (rustup, cargo)
  • Clone the repository
  • Install forge-cli
  • Run make install to deploy
  • Wire Claude Code hooks into ~/.claude/settings.json
  • Verify skill deployment
  • Verify git hooks are active

Steps

Clone

git clone https://github.com/N4M3Z/forge-core.git
cd forge-core

If already cloned, pull latest:

git pull

Check prerequisites

make validate

If forge shows MISSING, install forge-cli first:

git clone https://github.com/N4M3Z/forge-cli.git
cd forge-cli
make install
cd ../forge-core

Install

make install

Wire Claude Code hooks

Plugin users: hooks are auto-discovered from hooks/hooks.json when forge-core is installed as a Claude Code plugin (claude plugins add). No manual wiring needed.

forge-install users: forge install deploys skills, agents, and rules, but not hooks. Read hooks/hooks.json in this repository and add a corresponding record for each hook to ~/.claude/settings.json, replacing ${CLAUDE_PLUGIN_ROOT} with the absolute path to your clone.

Per-skill configuration

Some skills require user-config files the plugin system cannot create. Check for an INSTALL.md inside each skill directory (e.g., skills/VersionControl/INSTALL.md) and follow its setup steps after the module install.

Verify skill deployment

ls ~/.claude/skills/BuildSkill/SKILL.md

Verify git hooks

git config core.hooksPath

Should return .githooks. Pre-commit hooks validate ADR frontmatter, shell scripts, Rust, Python, and TypeScript when staged files match.

EXECUTE NOW: Complete the above TODO list.