{"id":49360401,"url":"https://github.com/ambient-code/session-config-reference","last_synced_at":"2026-04-27T16:02:13.031Z","repository":{"id":337554166,"uuid":"1154159303","full_name":"ambient-code/session-config-reference","owner":"ambient-code","description":"Reference repository demonstrating every Claude Code session configuration surface — CLAUDE.md, settings, rules, skills, agents, and MCP servers","archived":false,"fork":false,"pushed_at":"2026-02-10T05:04:27.000Z","size":17,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-10T09:48:16.105Z","etag":null,"topics":["agentic","claude-code","mcp","session-config","template"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ambient-code.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-10T04:30:03.000Z","updated_at":"2026-02-10T05:04:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ambient-code/session-config-reference","commit_stats":null,"previous_names":["ambient-code/session-config-reference"],"tags_count":null,"template":true,"template_full_name":null,"purl":"pkg:github/ambient-code/session-config-reference","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ambient-code%2Fsession-config-reference","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ambient-code%2Fsession-config-reference/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ambient-code%2Fsession-config-reference/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ambient-code%2Fsession-config-reference/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ambient-code","download_url":"https://codeload.github.com/ambient-code/session-config-reference/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ambient-code%2Fsession-config-reference/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32343571,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"online","status_checked_at":"2026-04-27T02:00:06.769Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic","claude-code","mcp","session-config","template"],"created_at":"2026-04-27T16:02:10.211Z","updated_at":"2026-04-27T16:02:13.015Z","avatar_url":"https://github.com/ambient-code.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Session Config Reference\n\nReference repository demonstrating every Claude Code configuration surface.\nClick **\"Use this template\"** to create your own config repo.\n\n## Quickstart\n\n```bash\n# 1. Click \"Use this template\" on GitHub, or clone directly:\ngh repo create my-org/my-session-config --template ambient-code/session-config-reference --public\ngh repo clone my-org/my-session-config \u0026\u0026 cd my-session-config\n\n# 2. Edit CLAUDE.md with your project conventions\n$EDITOR CLAUDE.md\n\n# 3. Push — ACP sessions using this as a config repo will pick it up automatically\ngit add -A \u0026\u0026 git commit -m \"chore: customize session config\" \u0026\u0026 git push\n```\n\nTo use in ACP: set this repo URL as the **Config Repo** in your workspace settings.\n\n## What's Inside\n\n```\nsession-config-reference/\n├── README.md                          # This file\n├── CLAUDE.md                          # Project-level session instructions\n├── .claude/\n│   ├── rules/\n│   │   └── security.md                # Global rule (no path filter)\n│   ├── skills/\n│   │   └── review/SKILL.md            # /review skill — code review\n│   └── agents/\n│       └── code-reviewer.md           # Read-only reviewer subagent\n├── .ambient/\n│   └── workflows/\n│       └── code-review.json           # Example workflow definition\n└── .mcp.json                          # MCP server (memory, zero-config)\n```\n\n## Configuration Surfaces\n\n### CLAUDE.md — Session Instructions\n\n`CLAUDE.md` is loaded into every Claude Code session. Use it to describe\nproject conventions, common commands, and any context Claude should know.\n\n**Location**: project root or `.claude/CLAUDE.md`\n\n### .claude/rules/ — Rules\n\nMarkdown files in `.claude/rules/` are loaded as additional instructions.\nRules can optionally include a `paths` frontmatter field with glob patterns\nto scope them to specific files.\n\nThis example has a single global rule (`security.md`) with no path filter,\nso it applies to all files.\n\n### .claude/skills/ — Skills\n\nSkills are invokable via `/skill-name` in the Claude Code CLI. Each skill\nlives in its own directory with a `SKILL.md` file containing YAML frontmatter\nand markdown instructions.\n\nThis example defines `/review`, which runs `git diff`, reads changed files,\nand reports bugs, security issues, and style violations grouped by severity.\n\n### .claude/agents/ — Subagents\n\nAgents are specialized Claude instances with scoped tools and a custom system\nprompt. Claude delegates to them automatically based on the `description`\nfield, or you can invoke them via the Task tool.\n\nThis example defines `code-reviewer`, a read-only agent that can only use\n`Read`, `Glob`, and `Grep` — it cannot modify files.\n\n### .mcp.json — MCP Servers\n\nDeclares Model Context Protocol servers that provide additional tools and\nresources. The `.mcp.json` file at the project root is checked into version\ncontrol so all collaborators share the same server configuration.\n\nThis example configures the `memory` server\n(`@modelcontextprotocol/server-memory`), which provides a persistent knowledge\ngraph — no API keys or infrastructure required.\n\n### .ambient/workflows/ — Workflows\n\nWorkflow definitions let you package reusable ACP workflows in your config\nrepo. Each workflow is a JSON file under `.ambient/workflows/` using the\nstandard ACP workflow format:\n\n```json\n{\n  \"name\": \"Workflow Name\",\n  \"description\": \"What this workflow does\",\n  \"systemPrompt\": \"Instructions for the agent\",\n  \"startupPrompt\": \"First message sent to the agent\",\n  \"results\": [\n    { \"path\": \"artifacts/output-dir/\" }\n  ]\n}\n```\n\n**Fields**:\n\n- **name** (required): Display name shown in the ACP UI\n- **description** (required): Brief description of the workflow's purpose\n- **systemPrompt** (required): System-level instructions for the agent\n- **startupPrompt** (required): The initial prompt sent when the session starts\n- **results** (optional): Array of output paths where artifacts are written\n\nThis example defines a `code-review` workflow that reviews repository code\nand writes findings to `artifacts/code-review/`.\n\n## How to Use This Template\n\n1. Click **\"Use this template\"** \u003e **\"Create a new repository\"**\n2. Edit the files to match your project's needs:\n   - Update `CLAUDE.md` with your project context and commands\n   - Add rules for your coding standards\n   - Create skills for your common tasks\n   - Define agents for specialized workflows\n   - Add workflows under `.ambient/workflows/`\n3. Commit and push — Claude Code will pick up the config automatically\n\n## Adding Your Own\n\n### Adding a New Skill\n\n```bash\nmkdir -p .claude/skills/my-skill\n```\n\nCreate `.claude/skills/my-skill/SKILL.md`:\n\n```yaml\n---\nname: my-skill\ndescription: Brief description of what this skill does\n---\n\n# My Skill\n\nInstructions for Claude when this skill is invoked.\n```\n\n### Adding a New Rule\n\nCreate `.claude/rules/my-rule.md`:\n\n```yaml\n---\npaths:\n  - \"**/*.ext\"\n---\n\n# My Rule\n\nStandards that apply to `.ext` files.\n```\n\n### Adding a New Workflow\n\nCreate `.ambient/workflows/my-workflow.json`:\n\n```json\n{\n  \"name\": \"My Workflow\",\n  \"description\": \"What this workflow does\",\n  \"systemPrompt\": \"You are an agent that...\",\n  \"startupPrompt\": \"Perform the task described above.\",\n  \"results\": [\n    { \"path\": \"artifacts/my-workflow/\" }\n  ]\n}\n```\n\n### Adding a New Agent\n\nCreate `.claude/agents/my-agent.md`:\n\n```yaml\n---\nname: my-agent\ndescription: What this agent does\ntools: Read, Glob, Grep\nmodel: sonnet\n---\n\nYou are a specialized agent for [task].\n```\n\n## Overlay Behavior\n\nWhen used as an ACP session-config repo, contents are overlaid into the\nworkspace:\n\n- Files are **added** to `.claude/` — they do not replace the entire directory\n- If a workspace repo also has `.claude/` files, the config repo files are\n  copied first, then the workspace repo's files take precedence\n- `CLAUDE.md` at the root level is placed in the workspace root\n- `.mcp.json` is placed in the workspace root\n\n## Further Reading\n\n- [Claude Code Settings](https://docs.anthropic.com/en/docs/claude-code/settings)\n- [Memory and CLAUDE.md](https://docs.anthropic.com/en/docs/claude-code/memory)\n- [Skills](https://docs.anthropic.com/en/docs/claude-code/skills)\n- [Sub-agents](https://docs.anthropic.com/en/docs/claude-code/sub-agents)\n- [Hooks](https://docs.anthropic.com/en/docs/claude-code/hooks)\n- [MCP Servers](https://docs.anthropic.com/en/docs/claude-code/mcp)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fambient-code%2Fsession-config-reference","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fambient-code%2Fsession-config-reference","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fambient-code%2Fsession-config-reference/lists"}