Arandu Shared Modules Guide

What it does

When your agent uses it

• Adding roles, groups or membership checks to an Arandu-based app
• Introducing credits, points or any balance that can be spent
• Adding tags, categories or labels to existing records
• Rendering Markdown or publishing OpenAPI docs for the HTTP routes

Example prompts

• “We need workspace members with admin and viewer roles. Should this go in the app or a shared module?”
• “Add a credits balance to each organization and make sure it can be refunded.”
• “Expose Swagger docs for our routes without writing a new OpenAPI generator.”

Requirements

• A project generated from the Arandu skeleton

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

1. 1AGENTS.md, then arandu-feature.
2. 2bootstrap/app.go: what Build constructs and passes to k.Register is
3. 3github.com/arandu-io/examples, the public reference application, before

What it can do on your machine

Read from SKILL.md and the folder at commit b8a4273. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • go
  • bash

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Arandu Shared Modules Guide loads about 1.8k tokens when it runs. Until then it costs about 153 tokens; SKILL.md has 848 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~153

When it runs · the whole SKILL.md, loaded when a task matches

~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from arandu-io/arandu at commit b8a4273, republished under its MIT licence (© arandu-io). 848 words, ~1,839 tokens.

name

arandu-ecosystem

description

Decide whether a feature belongs in this application or in a shared Arandu module, before adding or changing authorization, roles, organizations or tenants, balances, credits or any spendable unit, tags or labels, rendered Markdown, API documentation, Brazilian documents and money (CPF, CNPJ, BRL), or a helper such as a slug or a currency format. Use when a request mentions permissions, groups, members, workspaces, wallet, ledger, credits, points, tags, categories, Markdown, OpenAPI or Swagger, CPF/CNPJ, or when about to create a table, a package or a helper something else would also need.

license

MIT

package example

import (
	"github.com/arandu-io/hesape/number"
	"github.com/arandu-io/hesape/str"
)

// Listing is how a record is addressed and priced on a page: a slug for the
// address and a currency for the amount, held in cents.
func Listing(title string, cents int64) (slug, price string) {
	return str.Slug(title, "-"), number.CurrencyFromCents(cents, "USD")
}

export GOWORK=off
aru model:build --check
aru view:build
gofmt -l $(find . -name '*.go' -not -path '*/testdata/*' -not -name '*.kyse.go')
go vet ./...
bash tests/test-layout-guard.sh
go test -race ./...
go build ./...
aru doctor

<!-- arandu:begin custom -->

<!-- arandu:end custom -->

© arandu-io, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/arandu-ecosystem of arandu-io/arandu.

Open the folder on GitHubat commit b8a4273