CryptoSharia AI Foundation (SvelteKit)

Shared OpenCode AI rules and skills for CryptoSharia SvelteKit projects.

What this repo is

• A central place to maintain team-wide instructions (rules) and reusable skills.
• Consumed by projects via @jgordijn/opencode-remote-config (Git sync).

How projects consume it

Each project includes a .opencode/remote-config.json that points at this repo and tracks main.

Example:

{
  "installMethod": "copy",
  "repositories": [
    {
      "url": "https://github.com/cryptosharia/ai-foundation-sveltekit.git",
      "ref": "main",
      "instructions": "*",
      "skills": "*",
      "agents": "*",
      "commands": "*",
      "plugins": "*"
    }
  ]
}

Notes:

• Tracking main means updates apply automatically on OpenCode startup.
• This example imports everything, including instructions, skills, agents, commands, and plugins.

How to verify it works (in a consuming project)

1. Start OpenCode from the project root:

opencode

2. In OpenCode, run:

/skills

Expected: you see cryptosharia-api-integration, cryptosharia-planning-pack, cryptosharia-security-audit (and any other skills).

3. Ask the assistant something like:

What AI rules do you have?

Expected: it lists the CryptoSharia foundation rules (BFF pattern, security, conventions, planning, SvelteKit rules, etc.).

Optional checks (when debugging)

• Watch OpenCode startup logs for [remote-config] lines (clone/fetch and discovered skills/instructions).
• On Linux, remote repos are typically cached under ~/.cache/opencode/remote-config/repos/ (exact location may vary by OS).

Repo structure

manifest.json
instructions/
skill/
agent/        (optional)
command/      (optional)
plugin/       (optional)

Working on This Repo

When working inside ai-foundation-sveltekit itself, OpenCode also loads internal repo-only instructions from .agents/rules/*.md (configured in opencode.json).

These internal rules are for maintaining the foundation repo and are not intended to be exported to consuming app repos.

Instructions

• manifest.json lists instruction markdown files that should be imported.
• Add new instruction modules under instructions/ and remember to update manifest.json.
• Project entrypoint rules live in instructions/entrypoint.md.
• This repo's maintainer rules live in AGENTS.md (repo root) and are not imported into projects.

Skills

• Skills live under skill/<skill-name>/SKILL.md.
• Any references should be within the same skill folder (e.g. references/).
• Skill catalog and usage chains live in skill/README.md.

Change management

• Treat changes here as production-impacting (they affect how assistants behave across repos).
• Protect main, only commit to main once you're sure that the changes should be applied in production.