# Howdy Structure

> Create PHP classes following Howdy framework conventions. Use when creating new classes or files in the plugin.

- Skill: `majiayu000/howdy-structure` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/howdy-structure`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/howdy-structure/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/howdy-structure

---


# Howdy Structure Helper

## Instructions

When creating new PHP classes or files:

1. **Place in correct directory**:

    - Classes: `app/Namespace/Class.php`
    - Includes: `inc/` directory

2. **Apply namespace**:

    - Base: `Retrologin\`
    - Example: `Retrologin\Admin\Settings`

3. **Add required file header**:

    - `declare(strict_types=1);`
    - Docblock with description and `@since`

4. **Include ABSPATH check** at the top

## File Structure Pattern

```
retrologin.php          # Main plugin file (header only)
app/
  Admin/
    Settings.php        # Class: Retrologin\Admin\Settings
  Frontend/
    Login.php           # Class: Retrologin\Frontend\Login
inc/
  bootstrap/
    app.php             # Bootstrap file
```

## Class Template

```php
<?php

declare(strict_types=1);

/**
 * Short description of the class.
 *
 * Longer description if needed.
 *
 * @package Retrologin
 * @since   0.1.0
 */

namespace Retrologin\Admin;

if (! defined('ABSPATH')) {
    exit;
}

/**
 * Class description.
 *
 * @since 0.1.0
 */
class Settings {

    /**
     * Constructor.
     *
     * @since 0.1.0
     */
    public function __construct() {
        // Hooks, filters, etc.
    }

    /**
     * Method description.
     *
     * @param string $param Description.
     * @return void
     * @since 0.1.0
     */
    public function method( string $param ): void {
        // ...
    }
}
```

## Key Conventions

-   Autoloading: Composer's PSR-4 maps `Retrologin\` to `app/`
-   Don't manually `require` files - use autoloading
-   Coding standard: Syntatis (configured in phpcs.xml.dist)
-   Linter: `composer run lint`
-   Auto-fix: `composer run format`