ClearGrow DevPlatform

Claude Code configuration for the ClearGrow IoT development platform.

Overview

This repository contains Claude Code configuration files including sub-agents, skills, and slash commands for developing the ClearGrow agricultural monitoring system.

Platform Services

Service	URL	Purpose
Gitea	https://git.cleargrow.io	Git repository hosting
YouTrack	https://track.cleargrow.io	Issue tracking
TeamCity	https://ci.cleargrow.io	CI/CD pipelines

Repositories

Repository	Technology	Purpose
controller	ESP-IDF (C)	ESP32-S3 touchscreen controller
probe	Zephyr (C)	nRF52840 wireless sensor probes
docs	Markdown	Technical documentation

Contents

Sub-Agents

Specialized agents for different development tasks:

Agent	Purpose
controller-dev	ESP32-S3 firmware development with ESP-IDF
probe-dev	nRF52840 firmware development with Zephyr
docs-writer	Technical documentation
code-reviewer	Code review and quality
devops	Platform infrastructure
test-runner	Test automation

Skills

Auto-invoked capabilities for domain-specific tasks:

Skill	Domain
esp-idf	ESP-IDF, FreeRTOS, LVGL development
zephyr	Zephyr RTOS, nRF52840 development
documentation	Technical writing, Diátaxis framework
devplatform	Docker, Gitea, YouTrack, TeamCity

Slash Commands

Quick commands organized by category:

Firmware (/firmware:*)

• /build-controller, /build-probe - Build firmware
• /flash-controller, /flash-probe - Flash to device
• /test-controller, /test-probe - Run tests

Git (/git:*)

• /status, /commit, /push, /pull - Git operations
• /branch, /pr - Branch and PR management

Platform (/platform:*)

• /health, /logs, /restart - Service management
• /backup, /disk - Maintenance

Issues (/issues:*)

• /list, /view, /create - Issue management
• /comment, /transition, /start - Issue workflow

Quick Start

1. Clone this repo to your working directory
2. Claude Code will automatically load the configuration
3. Use /help to see available commands

git clone git@git.cleargrow.io:cleargrow/devplatform.git
cd devplatform

Safety Hooks

Pre-execution hooks protect against accidental service outages by requiring confirmation for dangerous commands:

Category	Protected Commands
Docker Compose	down, stop, rm, restart
Docker Containers	stop, kill, rm on platform containers
Systemctl	stop, disable, restart on critical services
System	reboot, shutdown, halt, poweroff
Destructive Deletes	rm -rf on platform directories
Database	DROP DATABASE, dropdb

When Claude attempts a dangerous command, you'll be prompted for confirmation before execution.

Files

.
├── CLAUDE.md              # Project context for Claude Code
├── QUICK_REFERENCE.md     # Command cheat sheet
├── SYSTEM_OVERVIEW.md     # Platform architecture
└── .claude/
    ├── settings.json      # Permissions and hooks configuration
    ├── agents/            # Sub-agent definitions
    ├── commands/          # Slash commands
    │   ├── firmware/      # Build/flash/test commands
    │   ├── git/           # Git workflow commands
    │   ├── platform/      # Service management
    │   └── issues/        # YouTrack integration
    ├── hooks/             # Safety hooks
    │   └── dangerous_command_check.py
    └── skills/            # Domain knowledge
        ├── esp-idf/
        ├── zephyr/
        ├── documentation/
        └── devplatform/

Documentation

• CLAUDE.md - Project conventions and context
• QUICK_REFERENCE.md - Command cheat sheet
• SYSTEM_OVERVIEW.md - Platform architecture

License

Proprietary - ClearGrow Inc.