Skip to content

GrazianoGuiducci/d-nd-seed

Repository files navigation

d-nd-seed

Your AI coder starts every session from zero. It forgets what it learned, repeats mistakes, loses context when the window compacts. You tell it the same things over and over.

This seed fixes that.

Install it in your project. The AI coder reads it and configures itself with hooks, memory, safety guards, and skills. What it learns persists. What it breaks, it catches first. When context compacts, it recovers.

Works with Claude Code, Cursor, Copilot, Gemini, and any AI coder that reads project files.

What changes after installation

Before After
Starts from zero every session Reads persistent memory, knows where it left off
Makes destructive mistakes silently Safety guard catches 9 dangerous patterns before execution
Loses everything on context compaction Pre-compact captures state, post-compact restores it
No structure for complex decisions 90 skills for reasoning, evaluation, self-improvement
You remind it of project conventions CLAUDE.md + hooks enforce them automatically

Quick start

git clone https://github.com/GrazianoGuiducci/d-nd-seed.git
cd d-nd-seed

# Preview what will be generated
./install.sh profiles/example.json --dry-run

# Install
./install.sh profiles/example.json

The installer reads your profile, adapts the templates, writes the configuration. Three files minimum: CLAUDE.md (identity), settings.json (hooks), MEMORY.md (persistent memory). Everything else is optional.

What is inside

17 hook templates that fire automatically:

Hook When What it does
Safety Guard Before every edit/command Catches destructive operations before they execute
System Awareness Session start Scans repos, git state, API health, unread messages
Session Monitor Every tool call Tracks boot compliance, guards memory writes, periodic reminders
Pre/Post Compact Context compaction Captures essential state before, restores it after
Cascade Check After modifications Asks: who else in the system needs to know?
Skill Health Session start Verifies skills have tests and triggers don't overlap

Each hook carries its own eval tests. You can verify they work.

103 skills across three categories:

Category Count For
Plugin skills 17 eval, dream, auto-learn, CEC, propagation, self-setup
Coder skills 33 Architecture, testing, debugging, deployment, review
Thinker skills 40 Reasoning, analysis, strategy (20 EN + 20 IT, for Chat AI)

Cognitive kernels — system prompts that shape how the AI thinks:

  • kernel_base — observe, relate, emerge, integrate
  • kernel_coder — safety, reversibility, multi-repo awareness, verification before assertion

Godel plugin — an inverted oracle. It does not answer questions. It inverts assumptions. You give it a tension, it shows you what you were hiding. Pre-built configurations for sales, research, finance.

Scenario Projector — maps the hidden structure in competing tensions. 4 structural lenses (focus, leverage, risk, blind spot), 5 pre-configured domains, action plans with domain-specific language. Complete guide.

Diagram Generator — reads article content and generates interactive conceptual diagrams. Two modes: LLM-powered (intelligent, understands narrative) and structural (rule-based, works offline). Output: JSON spec with neon nodes, directional relations, contextual copy. Complete guide.

Profiles

A profile describes your environment. The installer uses it to generate everything:

{
  "node_id": "MY_NODE",
  "project_dir": "/path/to/project",
  "repos": [
    { "name": "my-app", "path": "my-app", "branch": "main" }
  ]
}

Optional: vps_url, godel config, sinapsi_for (inter-node messaging). See profiles/example.json.

How it works

Hooks fire at the right moments. You do not invoke them.

At session start, the system scans your repos and tells the AI what changed. Before every tool call, the safety guard checks for destructive patterns. When context compacts, the pre-compact hook captures the reasoning state — what you were doing, why, what was next. The post-compact hook restores it.

Skills activate when the context requires them. The AI evaluates its own skills (/eval), consolidates its memory (/dream), learns from its mistakes (/auto-learn). Every skill carries its own tests.

The seed adapts to the host. It reads the environment, generates configuration for it, then the configuration maintains itself. The seed file is no longer needed — it became the system it generated.

Architecture

d-nd-seed/
├── GUIDE.md              # AI reads this first — full map + setup procedure
├── install.sh            # Parametric installer (reads profile, writes config)
├── profiles/             # Environment configurations
├── templates/
│   ├── hooks/            # 17 hook templates (.sh.tmpl, parametric)
│   └── skills/           # Installable skill templates
├── skills/
│   ├── coder/            # 42 skills for coding agents
│   └── thinker/          # 44 bilingual skills for chat AI
├── kernels/              # Cognitive system prompts (base, coder)
├── plugins/
│   ├── d-nd-core/        # Core: safety, awareness, inter-node messaging
│   └── godel/            # Inverted oracle with domain configurations
├── docs/                 # 14 operational guides
└── scripts/              # Maintenance tools

Upgrading

If you're running a previous version, see UPGRADING.md for breaking changes and migration steps.

How the system works at maturity

The seed installs the structure. What grows from it is described in OPERATIONAL_MATURITY.md — how the system thinks, protects itself, and evolves after installation. Seven patterns that transfer across any node.

For AI in a chat session

If you are using Claude.ai, ChatGPT, or Gemini (not a coding agent): start with CHAT_START.md. It contains the skills and instructions adapted for conversation.

Part of D-ND

D-ND (Dual-Non-Dual) is the framework behind this seed. The mathematical model, the research, and the tools live at d-nd.com.

License

AGPL-3.0 — see LICENSE

About

A self-configuring cognitive system for AI coders. The seed installs itself, learns from itself, and persists through discontinuity. Hooks, skills, memory, safety. Works with Claude Code, Cursor, Copilot, Gemini.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors