Visitar URL original
Add AGENTS.md with cloud-specific development instructions by marekdkropiewnicki-dotcom · Pull Request #2 · marekdkropiewnicki-dotcom/.github · GitHub
Skip to content

Add AGENTS.md with cloud-specific development instructions - #2

Merged
marekdkropiewnicki-dotcom merged 3 commits into
mainfrom
cursor/dev-env-setup-2c16
May 7, 2026
Merged

marekdkropiewnicki-dotcom merged 3 commits into
mainfrom
cursor/dev-env-setup-2c16

Conversation

@marekdkropiewnicki-dotcom

Copy link
Copy Markdown
Owner

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

Open in Web Open in Cursor 

Co-authored-by: QuantuM <qumusai@proton.me>

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

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

@marekdkropiewnicki-dotcom marekdkropiewnicki-dotcom left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

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

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

Open in Web Open in Cursor

@marekdkropiewnicki-dotcom

Copy link
Copy Markdown
Owner Author

@copilot
Remember, contributions to this repository should follow its contributing guidelines, security policy, and code of conduct.
Add comments to specific lines under Files changed.

@marekdkropiewnicki-dotcom

Copy link
Copy Markdown
Owner Author

@copilot resolve the merge conflicts in this pull request

Co-authored-by: marekdkropiewnicki-dotcom <259442047+marekdkropiewnicki-dotcom@users.noreply.github.com>

Copilot AI commented May 7, 2026

Copy link
Copy Markdown

@copilot resolve the merge conflicts in this pull request

Resolved the merge conflict with main in 81bea69. The conflict was in AGENTS.md (both branches added different versions). I combined the two: kept the structured sections from this branch and incorporated the --dryRun flag and ruleset rule list from main.

@marekdkropiewnicki-dotcom marekdkropiewnicki-dotcom left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

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

Overview
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

Open in Web Open in Cursor

@marekdkropiewnicki-dotcom marekdkropiewnicki-dotcom left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

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

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

Open in Web Open in Cursor

@marekdkropiewnicki-dotcom
marekdkropiewnicki-dotcom marked this pull request as ready for review May 7, 2026 19:56
Copilot AI review requested due to automatic review settings May 7, 2026 19:56

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Adds an AGENTS.md guide intended for Cursor Cloud, documenting what this org-level .github meta-repo contains and which local verification commands are relevant.

Changes:

  • Introduces AGENTS.md describing repository contents and the absence of an app build/test/dev-server workflow.
  • Documents how to run repolinter with the repo’s custom ruleset and how to run markdownlint.
  • Captures “known issues/gotchas” for contributors (with a couple items currently out of date vs the repo state).

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

Comment thread AGENTS.md Outdated
### Known issues

This checks 3 rules: `license-file-is-MIT`, `readme-file-exists`, and `codeowners-file-exists`.
- `config/repolinter-ruleset.json` has a trailing comma on the last rule entry (line 65-66), which makes it invalid strict JSON. Repolinter's parser handles it, but `JSON.parse()` and `python3 json.load()` will fail. Do not attempt to "fix" this unless explicitly asked.
Comment thread AGENTS.md Outdated
This checks 3 rules: `license-file-is-MIT`, `readme-file-exists`, and `codeowners-file-exists`.
- `config/repolinter-ruleset.json` has a trailing comma on the last rule entry (line 65-66), which makes it invalid strict JSON. Repolinter's parser handles it, but `JSON.parse()` and `python3 json.load()` will fail. Do not attempt to "fix" this unless explicitly asked.
- `CONTRIBUTING.md` references `script/bootstrap` and `script/cibuild` commands that do not exist in this repository — they are generic placeholder instructions.
- Repolinter's `license-file-is-MIT` rule will flag a warning because this repo has no LICENSE file (expected for an org-level `.github` repo).
Comment thread AGENTS.md Outdated
- `config/repolinter-ruleset.json` has a trailing comma on the last rule entry (line 65-66), which makes it invalid strict JSON. Repolinter's parser handles it, but `JSON.parse()` and `python3 json.load()` will fail. Do not attempt to "fix" this unless explicitly asked.
- `CONTRIBUTING.md` references `script/bootstrap` and `script/cibuild` commands that do not exist in this repository — they are generic placeholder instructions.
- Repolinter's `license-file-is-MIT` rule will flag a warning because this repo has no LICENSE file (expected for an org-level `.github` repo).
- Running `repolinter lint` without `--dryRun` may auto-create a `CODEOWNERS` file via its fix rule. Clean up with `rm -f CODEOWNERS` if this happens unintentionally.

@cursor cursor Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Stale comment

Risk assessment: Very Low

Diff against main is a single file (AGENTS.md, +16/-9) — a documentation-only update to the Cursor agent instructions in this .github org meta-repo. No application code, services, infra, auth, or schema are touched. The post-approval update is a merge from main with only cosmetic AGENTS.md tweaks, so risk has not increased.

  • Reviewers required: none
  • Action: not approving (PR already has an approval from cubic-dev-ai)
  • No revocation needed (risk did not increase since prior approval)
Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

Address PR #2 review feedback from Copilot:

- Remove the 'trailing comma in repolinter-ruleset.json' bullet — the
  file is now valid strict JSON (fixed in PR #8).
- Remove the 'no LICENSE file' bullet — the repo now ships an MIT
  LICENSE (added in PR #8), so license-file-is-MIT no longer warns.
- Rewrite the CODEOWNERS cleanup guidance to use 'git restore' rather
  than 'rm -f', because CODEOWNERS (and LICENSE) are now tracked files
  and 'rm' would delete real content. Also call out that running
  without --dryRun can overwrite both tracked files via fix rules.

Co-authored-by: QuantuM <qumusai@proton.me>

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Risk assessment: Very Low

Latest push (e8f6eb4) is still a single-file, docs-only update to AGENTS.md in this .github org meta-repo (community-health files + a repolinter config; no application code, services, infra, auth, or schema). The new commit just trims two stale "Known issues" bullets and rewrites cleanup guidance to use git restore instead of rm -f on tracked files. Cumulative diff vs main: AGENTS.md only, +14/-9.

  • Reviewers required: none
  • Reviewers added: none (would not exceed the 2-reviewer cap regardless)
  • Action: not approving — PR is already approved by cubic-dev-ai
  • No revocation needed: risk has not increased since the prior approval
Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

0 issues found across 1 file (changes from recent commits).

@marekdkropiewnicki-dotcom
marekdkropiewnicki-dotcom merged commit 9d10b54 into main May 7, 2026
4 checks passed
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.

4 participants