Skip to content

docs: add CLAUDE.md for developer and agent guidance#25

Merged
whoabuddy merged 2 commits intomainfrom
quest/prod-readiness/add-claude-md
Feb 17, 2026
Merged

docs: add CLAUDE.md for developer and agent guidance#25
whoabuddy merged 2 commits intomainfrom
quest/prod-readiness/add-claude-md

Conversation

@whoabuddy
Copy link
Contributor

Summary

  • Creates CLAUDE.md from scratch for the openclaw-aibtc repo
  • Documents project overview and how OpenClaw connects to the aibtc MCP server via mcporter
  • Covers Docker workflow (build, run, update, full rebuild)
  • Documents directory structure with container paths table
  • Explains skill authoring conventions (SKILL.md format, YAML frontmatter requirements)
  • Documents the 4-tier security model and spending limit configuration
  • Includes all CI check commands to run locally before pushing
  • Covers data persistence model (volume mounts, symlinks, migration)
  • Provides guide for adding new skills and updating the base image

Test plan

  • Markdown lint passes (npx markdownlint-cli2 "CLAUDE.md" - 0 errors)
  • Human review for accuracy and completeness
  • Copilot review

Part of the Production Readiness Sweep quest (Phase 5A).

Generated with Claude Code

Documents project overview, Docker workflow, directory structure,
skill authoring conventions (SKILL.md format, mcporter integration,
4-tier security model), CI checks, and how to add new skills.

Co-Authored-By: Claude <noreply@anthropic.com>
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds comprehensive developer and agent guidance documentation to the openclaw-aibtc repository through a new CLAUDE.md file. The documentation serves as an authoritative reference for understanding the project structure, Docker workflow, skill authoring conventions, security model, and development practices for this OpenClaw deployment pre-configured with Bitcoin and Stacks blockchain tools.

Changes:

  • Created CLAUDE.md with complete project documentation covering architecture, setup, configuration, and development workflows
  • Documented the 4-tier security model for autonomous blockchain operations
  • Provided comprehensive CI check commands for local development validation

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

- fix journal.md path to include memory/ subdirectory
- add entrypoint.sh to shellcheck command to match CI
- fix JSON validation to use proper exit status tracking pattern
- expand YAML frontmatter validation to match CI implementation
- add missing env-var-coverage check section

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@whoabuddy whoabuddy merged commit 547cf33 into main Feb 17, 2026
8 checks passed
@whoabuddy whoabuddy deleted the quest/prod-readiness/add-claude-md branch February 17, 2026 06:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants