Add AGENTS.md with cloud-specific development instructions

[marekdkropiewnicki-dotcom]

Summary

Adds AGENTS.md with Cursor Cloud specific instructions for this documentation-only .github organization repository.

What this covers

• Repository structure overview (community health files + repolinter config)
• Available dev tool commands (repolinter lint, markdownlint)
• Known issues and gotchas (trailing comma in JSON config, placeholder script/bootstrap references, repolinter auto-creating CODEOWNERS)

Dev environment verification

The following tools were verified as working:

• repolinter — runs repo policy checks with the custom ruleset at config/repolinter-ruleset.json
• markdownlint — lints all Markdown files in the repo

Logs from the verification run:

dev_environment_output.log

  

[cubic-dev-ai]

No issues found across 1 file

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

Architecture diagram

sequenceDiagram
    participant Agent as Developer / Cursor Agent
    participant Instr as NEW: AGENTS.md
    participant Linter as Repolinter
    participant MD as Markdownlint
    participant FS as Local Filesystem
    participant GH as GitHub Organization

    Note over Agent,GH: Repository Development & Health Check Flow

    Agent->>Instr: NEW: Read environment & tool instructions
    
    rect rgb(240, 240, 240)
        Note right of Agent: Repolinter Workflow
        Agent->>Linter: Execute lint --rulesetFile config/repolinter-ruleset.json
        Linter->>FS: Load custom JSON ruleset
        Note over Linter,FS: Note: Ruleset contains trailing commas
        Linter->>FS: Verify README, SECURITY, LICENSE
        
        alt Fix Rule Triggered
            Linter->>FS: CHANGED: Auto-create CODEOWNERS file
            Agent->>FS: Manual cleanup (rm CODEOWNERS)
        end
    end

    rect rgb(240, 240, 240)
        Note right of Agent: Markdown Quality Workflow
        Agent->>MD: Execute lint on *.md and profile/*.md
        MD-->>Agent: Return warnings/errors
    end

    Note over FS,GH: Deployment / Rendering
    GH->>FS: Fetch profile/README.md
    GH-->>GH: Display as Organization Profile Page

Loading