Skillget

grainulation

mcp
Security Audit
Fail
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Fail
  • fs module — File system access in .github/workflows/publish.yml
  • execSync — Synchronous shell command execution in lib/doctor.js
  • fs module — File system access in lib/doctor.js
  • fs module — File system access in lib/pm.js
  • fs module — File system access in lib/router.js
  • execSync — Synchronous shell command execution in lib/server.mjs
  • execSync — Synchronous shell command execution in lib/setup.js
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

The grainulation ecosystem. Structured research, decision-making, and knowledge management for AI agents.

README.md

grainulation

npm version npm downloads license node CI Explore on DeepWiki

Structured research for decisions that satisfice.

Most decisions fail not because the team lacked data, but because they lacked a process for turning data into evidence and evidence into conviction. Grainulation is that process.

You start with a question. You grow evidence: claims with types, confidence levels, and evidence tiers. You challenge what you find. You look for blind spots. And only when the evidence compiles -- when conflicts are resolved and gaps are acknowledged -- do you write the brief.

Install

npm install -g @grainulation/grainulation

Or start a research sprint directly:

npx @grainulation/wheat init

Quick start

grainulation              # Ecosystem overview
grainulation doctor       # Health check: which tools, which versions
grainulation setup        # Install the right tools for your role
grainulation wheat init   # Delegate to any tool
grainulation farmer start

The ecosystem

Eight tools. Each does one thing. Use what you need.

Tool What it does Install
wheat Research engine. Grow structured evidence. npx @grainulation/wheat init
farmer Permission dashboard. Approve AI actions in real time (admin + viewer roles). npm i -g @grainulation/farmer
barn Shared tools. Templates, validators, sprint detection. npm i -g @grainulation/barn
mill Format conversion. Export to PDF, CSV, slides, 24 formats. npm i -g @grainulation/mill
silo Knowledge storage. Reusable claim libraries and packs. npm i -g @grainulation/silo
harvest Analytics. Cross-sprint patterns and prediction scoring. npm i -g @grainulation/harvest
orchard Orchestration. Multi-sprint coordination and dependencies. npm i -g @grainulation/orchard
grainulation Unified CLI. Single entry point to the ecosystem. npm i -g @grainulation/grainulation

You don't need all eight. Start with wheat. That's it. One command. Everything else is optional -- add tools when you feel the friction.

The journey

Question --> Seed Claims --> Grow Evidence --> Compile Brief
  /init       /research       /challenge        /brief
                              /blind-spot
                              /witness

Every step is tracked. Every claim has provenance. Every decision is reproducible.

Philosophy

Satisficing over maximizing. You will never have perfect information. The goal is enough evidence to make a defensible decision, not a perfect one.

Claims over opinions. Every finding is a typed claim with an evidence tier. "I think" becomes "r003: factual, tested -- measured 340ms p95 latency under load."

Adversarial pressure over consensus. The /challenge command exists because comfortable agreement is the enemy of good decisions.

Process over heroics. A reproducible sprint that anyone can pick up beats a brilliant analysis that lives in one person's head.

Zero dependencies

Every grainulation tool runs on Node built-ins only. No npm install waterfall. No left-pad. No supply chain anxiety.

The name

You build the crop (wheat), the steward (farmer), the barn, the mill, the silo, the harvest, the orchard -- and only then do you name the machine that connects them all.

Grainulation: the machine that processes the grain.

License

MIT

Reviews (0)

No results found