management

Document the squash-bot management service architecture for API handlers, business logic, scheduler jobs, and storage.

2|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/hutoroff/squash-bot --skill management-hutoroff
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: management
Source: https://github.com/hutoroff/squash-bot/tree/main/.claude/skills/management
Command: npx skills add https://github.com/hutoroff/squash-bot --skill management-hutoroff

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The management service architecture reference provides a comprehensive map of how the squash-bot's central backend components interact, helping engineers understand data flow, responsibilities, and integration points before making changes.

Core Features & Use Cases

  • Documents the central data hub: PostgreSQL storage, business logic, cron scheduler, and HTTP APIs; the Telegram bot and web service interactions are described as external clients.
  • Describes key packages and their responsibilities (cmd/management, api, service, storage) and how they communicate.
  • Use case: a developer planning an API handler change can consult this reference to identify touched modules and interfaces.

Quick Start

Simply read this architecture reference before planning any API or service changes to align implementation with the defined architecture.

Frequently Asked Questions about management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a backend management service with PostgreSQL and a cron scheduler?

A backend management service with PostgreSQL and a cron scheduler should segregate entry points, business logic, storage interactions, and API handlers into distinct packages like cmd, api, service, and storage to ensure correct integration and clear data flow.

What is the best way to plan API handler changes in a microservice architecture?

The best way to plan API handler changes is to consult an architecture reference mapping module responsibilities and integration points. This identifies touched packages and interfaces before implementation, ensuring changes align with the defined architecture.

How does the squash-bot management service interact with external clients like Telegram bots?

The squash-bot management service acts as a central data hub exposing HTTP APIs. External clients like the Telegram bot and web services interact with these APIs, while the core service handles PostgreSQL storage, business logic, and cron scheduling.

Can I use this architecture reference to guide cron scheduler job implementation?

Yes, you can use this architecture reference to guide cron scheduler job implementation. It enumerates entry points, package structures, and interfaces applicable during the planning and implementation of scheduler jobs and storage interactions.

What packages are needed for a management service handling API requests and scheduled jobs?

A management service handling API requests and scheduled jobs requires packages for command execution (cmd/management), API routing (api), business logic (service), and database operations (storage) to maintain separation of concerns.

When do I need an architecture reference for backend service development?

You need an architecture reference for backend service development before planning any API or service changes. It provides a comprehensive map of component interactions, data flow, and responsibilities, preventing inconsistent integration across modules.