Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
88 changes: 88 additions & 0 deletions .agents/skills/cursor-profile-manager/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,88 @@
```markdown
# cursor-profile-manager Development Patterns

> Auto-generated skill from repository analysis

## Overview
This skill teaches you the core development patterns and conventions used in the `cursor-profile-manager` Python codebase. You'll learn how to structure files, write imports and exports, follow commit conventions, and implement and test features in a consistent, maintainable way.

## Coding Conventions

### File Naming
- Use **PascalCase** for all file names.
- Example: `UserProfileManager.py`, `ProfileSettings.py`

### Import Style
- Use **relative imports** within the package.
- Example:
```python
from .UserProfileManager import UserProfileManager
from .ProfileSettings import ProfileSettings
```

### Export Style
- Use **named exports** by explicitly listing classes or functions in `__all__`.
- Example:
```python
__all__ = ["UserProfileManager", "ProfileSettings"]
```

### Commit Patterns
- Mixed commit types, with prefixes like `docs` and `feat`.
- Commit messages are concise, averaging ~58 characters.
- Example:
```
feat: add support for multiple profile types
docs: update README with usage examples
```

## Workflows

### Feature Implementation
**Trigger:** When adding a new feature
**Command:** `/feature-implementation`

1. Create a new PascalCase Python file for the feature.
2. Implement the feature using relative imports as needed.
3. Add the new class or function to the module's `__all__` list.
4. Write or update tests in a corresponding `*.test.*` file.
5. Commit changes with a `feat:` prefix and a concise description.

### Documentation Update
**Trigger:** When updating or adding documentation
**Command:** `/docs-update`

1. Edit or create documentation files as needed.
2. Ensure code examples follow the project's conventions.
3. Commit changes with a `docs:` prefix and a concise description.

### Testing
**Trigger:** When writing or running tests
**Command:** `/run-tests`

1. Create or update test files matching the `*.test.*` pattern.
2. Use the project's preferred (unknown) testing framework.
3. Run tests and ensure all pass before merging changes.

## Testing Patterns

- Test files follow the `*.test.*` naming convention, such as `UserProfileManager.test.py`.
- The specific testing framework is not specified, but tests should reside in files matching the pattern above.
- Example test file:
```python
# UserProfileManager.test.py
from .UserProfileManager import UserProfileManager

def test_profile_creation():
manager = UserProfileManager()
profile = manager.create_profile("Alice")
assert profile.name == "Alice"
```

## Commands
| Command | Purpose |
|------------------------|-----------------------------------------------|
| /feature-implementation| Step-by-step guide for adding new features |
| /docs-update | Instructions for updating documentation |
| /run-tests | How to write and execute tests |
```
6 changes: 6 additions & 0 deletions .agents/skills/cursor-profile-manager/agents/openai.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
interface:
display_name: "Cursor Profile Manager"
short_description: "Repo-specific patterns and workflows for cursor-profile-manager"
default_prompt: "Use the cursor-profile-manager repo skill to follow existing architecture, testing, and workflow conventions."
policy:
allow_implicit_invocation: true
276 changes: 276 additions & 0 deletions .claude/ecc-tools.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,276 @@
{
"version": "1.3",
"schemaVersion": "1.0",
"generatedBy": "ecc-tools",
"generatedAt": "2026-07-23T17:45:33.119Z",
"repo": "https://github.com/jpolvora/cursor-profile-manager",
"referenceSetReadiness": {
"score": 14,
"present": 1,
"total": 7,
"items": [
{
"id": "deep-analyzer-corpus",
"label": "Deep analyzer corpus",
"status": "missing",
"evidence": [],
"recommendation": "Add analyzer fixture, golden, benchmark, or reference-set files that can catch analyzer regressions."
},
{
"id": "rag-evaluator",
"label": "RAG/evaluator comparison",
"status": "missing",
"evidence": [],
"recommendation": "Add retrieval or evaluator reference-set comparison fixtures with expected ranking behavior."
},
{
"id": "pr-salvage",
"label": "PR salvage/review corpus",
"status": "missing",
"evidence": [],
"recommendation": "Add stale-PR, review-thread, reopen-flow, or salvage reference cases for queue cleanup automation."
},
{
"id": "discussion-triage",
"label": "Discussion triage corpus",
"status": "missing",
"evidence": [],
"recommendation": "Add public discussion triage fixtures, golden cases, or reference sets for informational, answered, and no-response classifications."
},
{
"id": "harness-compatibility",
"label": "Harness compatibility",
"status": "present",
"evidence": [
".agents/plans/github-pages-site/step-02-github-pages-site.plan.refined.md",
".agents/plans/github-pages-site/step-08-github-pages-site.result.md",
".agents/skills/00-write-spec/SKILL.md"
],
"recommendation": "Add cross-harness, adapter-compliance, or harness-audit evidence for Claude, Codex, OpenCode, Zed, dmux, and agent surfaces."
},
{
"id": "security-evidence",
"label": "Security evidence",
"status": "missing",
"evidence": [],
"recommendation": "Attach security evidence such as SBOMs, SARIF, audit reports, or AgentShield evidence packs."
},
{
"id": "ci-failure-mode",
"label": "CI failure-mode evidence",
"status": "missing",
"evidence": [],
"recommendation": "Add captured CI failure logs, dry-run fixtures, or troubleshooting docs for common workflow failure modes."
}
]
},
"profiles": {
"requested": "full",
"recommended": "full",
"effective": "developer",
"requestedAlias": "full",
"recommendedAlias": "full",
"effectiveAlias": "developer"
},
"requestedProfile": "full",
"profile": "developer",
"recommendedProfile": "full",
"effectiveProfile": "developer",
"tier": "free",
"requestedComponents": [
"repo-baseline",
"workflow-automation",
"security-audits",
"research-tooling",
"team-rollout",
"governance-controls"
],
"selectedComponents": [
"repo-baseline",
"workflow-automation"
],
"requestedAddComponents": [],
"requestedRemoveComponents": [],
"blockedRemovalComponents": [],
"tierFilteredComponents": [
"security-audits",
"research-tooling",
"team-rollout",
"governance-controls"
],
"requestedRootPackages": [
"runtime-core",
"workflow-pack",
"agentshield-pack",
"research-pack",
"team-config-sync",
"enterprise-controls"
],
"selectedRootPackages": [
"runtime-core",
"workflow-pack"
],
"requestedPackages": [
"runtime-core",
"workflow-pack",
"agentshield-pack",
"research-pack",
"team-config-sync",
"enterprise-controls"
],
"requestedAddPackages": [],
"requestedRemovePackages": [],
"selectedPackages": [
"runtime-core",
"workflow-pack"
],
"packages": [
"runtime-core",
"workflow-pack"
],
"blockedRemovalPackages": [],
"tierFilteredRootPackages": [
"agentshield-pack",
"research-pack",
"team-config-sync",
"enterprise-controls"
],
"tierFilteredPackages": [
"agentshield-pack",
"research-pack",
"team-config-sync",
"enterprise-controls"
],
"conflictingPackages": [],
"dependencyGraph": {
"runtime-core": [],
"workflow-pack": [
"runtime-core"
]
},
"resolutionOrder": [
"runtime-core",
"workflow-pack"
],
"requestedModules": [
"runtime-core",
"workflow-pack",
"agentshield-pack",
"research-pack",
"team-config-sync",
"enterprise-controls"
],
"selectedModules": [
"runtime-core",
"workflow-pack"
],
"modules": [
"runtime-core",
"workflow-pack"
],
"managedFiles": [
".claude/skills/cursor-profile-manager/SKILL.md",
".agents/skills/cursor-profile-manager/SKILL.md",
".agents/skills/cursor-profile-manager/agents/openai.yaml",
".claude/identity.json",
".codex/config.toml",
".codex/AGENTS.md",
".codex/agents/explorer.toml",
".codex/agents/reviewer.toml",
".codex/agents/docs-researcher.toml",
".claude/homunculus/instincts/inherited/cursor-profile-manager-instincts.yaml"
],
"packageFiles": {
"runtime-core": [
".claude/skills/cursor-profile-manager/SKILL.md",
".agents/skills/cursor-profile-manager/SKILL.md",
".agents/skills/cursor-profile-manager/agents/openai.yaml",
".claude/identity.json",
".codex/config.toml",
".codex/AGENTS.md",
".codex/agents/explorer.toml",
".codex/agents/reviewer.toml",
".codex/agents/docs-researcher.toml",
".claude/homunculus/instincts/inherited/cursor-profile-manager-instincts.yaml"
]
},
"moduleFiles": {
"runtime-core": [
".claude/skills/cursor-profile-manager/SKILL.md",
".agents/skills/cursor-profile-manager/SKILL.md",
".agents/skills/cursor-profile-manager/agents/openai.yaml",
".claude/identity.json",
".codex/config.toml",
".codex/AGENTS.md",
".codex/agents/explorer.toml",
".codex/agents/reviewer.toml",
".codex/agents/docs-researcher.toml",
".claude/homunculus/instincts/inherited/cursor-profile-manager-instincts.yaml"
]
},
"files": [
{
"moduleId": "runtime-core",
"path": ".claude/skills/cursor-profile-manager/SKILL.md",
"description": "Repository-specific Claude Code skill generated from git history."
},
{
"moduleId": "runtime-core",
"path": ".agents/skills/cursor-profile-manager/SKILL.md",
"description": "Codex-facing copy of the generated repository skill."
},
{
"moduleId": "runtime-core",
"path": ".agents/skills/cursor-profile-manager/agents/openai.yaml",
"description": "Codex skill metadata so the repo skill appears cleanly in the skill interface."
},
{
"moduleId": "runtime-core",
"path": ".claude/identity.json",
"description": "Suggested identity.json baseline derived from repository conventions."
},
{
"moduleId": "runtime-core",
"path": ".codex/config.toml",
"description": "Repo-local Codex MCP and multi-agent baseline aligned with ECC defaults."
},
{
"moduleId": "runtime-core",
"path": ".codex/AGENTS.md",
"description": "Codex usage guide that points at the generated repo skill and workflow bundle."
},
{
"moduleId": "runtime-core",
"path": ".codex/agents/explorer.toml",
"description": "Read-only explorer role config for Codex multi-agent work."
},
{
"moduleId": "runtime-core",
"path": ".codex/agents/reviewer.toml",
"description": "Read-only reviewer role config focused on correctness and security."
},
{
"moduleId": "runtime-core",
"path": ".codex/agents/docs-researcher.toml",
"description": "Read-only docs researcher role config for API verification."
},
{
"moduleId": "runtime-core",
"path": ".claude/homunculus/instincts/inherited/cursor-profile-manager-instincts.yaml",
"description": "Continuous-learning instincts derived from repository patterns."
}
],
"workflows": [],
"adapters": {
"claudeCode": {
"skillPath": ".claude/skills/cursor-profile-manager/SKILL.md",
"identityPath": ".claude/identity.json",
"commandPaths": []
},
"codex": {
"configPath": ".codex/config.toml",
"agentsGuidePath": ".codex/AGENTS.md",
"skillPath": ".agents/skills/cursor-profile-manager/SKILL.md"
}
}
}
Loading