@dezkareid/ai-team 0.0.4 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +117 -0
- package/README.md +46 -1
- package/gemini-extension.json +2 -2
- package/package.json +27 -8
package/AGENTS.md
ADDED
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
# Agent Instructions: AI Team Project
|
|
2
|
+
|
|
3
|
+
This project is a collection of AI utils like agents/commands/skills and more that are intended to be used together to use AI tools more effectively.
|
|
4
|
+
|
|
5
|
+
## Overview
|
|
6
|
+
|
|
7
|
+
Support different AI agents/commands/skills formats:
|
|
8
|
+
|
|
9
|
+
### Command File Formats
|
|
10
|
+
|
|
11
|
+
#### Markdown Format
|
|
12
|
+
|
|
13
|
+
Used by: Claude Code, Cursor, opencode, Windsurf, Amazon Q Developer, Amp, SHAI, IBM Bob
|
|
14
|
+
|
|
15
|
+
**Standard format:**
|
|
16
|
+
|
|
17
|
+
Used by Claude Code
|
|
18
|
+
|
|
19
|
+
```markdown
|
|
20
|
+
---
|
|
21
|
+
description: "Command description"
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
Command content with {SCRIPT} and $ARGUMENTS placeholders.
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
#### TOML Format
|
|
28
|
+
|
|
29
|
+
Used by: Gemini
|
|
30
|
+
|
|
31
|
+
```toml
|
|
32
|
+
description = "Command description"
|
|
33
|
+
|
|
34
|
+
prompt = """
|
|
35
|
+
Command content with {SCRIPT} and {{args}} placeholders.
|
|
36
|
+
"""
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### Organization
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
### Argument Patterns
|
|
43
|
+
|
|
44
|
+
Different agents use different argument placeholders:
|
|
45
|
+
|
|
46
|
+
- **Markdown/prompt-based**: `$ARGUMENTS`
|
|
47
|
+
- **TOML-based**: `{{args}}`
|
|
48
|
+
|
|
49
|
+
## Development
|
|
50
|
+
|
|
51
|
+
File `.agent-structurerc` is used to configure the project structure.
|
|
52
|
+
|
|
53
|
+
```json
|
|
54
|
+
{
|
|
55
|
+
"claude-plugins": {
|
|
56
|
+
"npm-tools": {
|
|
57
|
+
"name": "npm-tools",
|
|
58
|
+
"description": "Tools for working with npm"
|
|
59
|
+
}
|
|
60
|
+
},
|
|
61
|
+
"commands": [
|
|
62
|
+
{
|
|
63
|
+
"id": "npm-package-setup",
|
|
64
|
+
"source": "npm/package-setup.toml",
|
|
65
|
+
"claude-plugin": "npm-tools"
|
|
66
|
+
}
|
|
67
|
+
]
|
|
68
|
+
}
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
### Claude Plugin Structure
|
|
72
|
+
|
|
73
|
+
```
|
|
74
|
+
plugins/
|
|
75
|
+
└── <claude-plugin>/
|
|
76
|
+
├── .claude-plugin/
|
|
77
|
+
│ ├── plugin.json
|
|
78
|
+
├──commands/
|
|
79
|
+
│ ├── <command-name>.md
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
### Commit Rules
|
|
83
|
+
|
|
84
|
+
Always use Conventional Commits format for commit messages.
|
|
85
|
+
|
|
86
|
+
Never commit directly to `main` or `master`. If the current branch is one of them, propose creating a new branch before committing.
|
|
87
|
+
|
|
88
|
+
### Critical Dependency Versions
|
|
89
|
+
|
|
90
|
+
The following versions are established across the project's packages and should be respected when adding new dependencies or troubleshooting.
|
|
91
|
+
|
|
92
|
+
Always prefer use exact versions for dependencies. Do not use `^` or `~`.
|
|
93
|
+
|
|
94
|
+
#### Core Languages & Runtimes
|
|
95
|
+
- **TypeScript**: `5.9.3`
|
|
96
|
+
|
|
97
|
+
#### Build & Bundling Tools
|
|
98
|
+
- **Rollup**: `4.56.0`
|
|
99
|
+
|
|
100
|
+
#### Testing Frameworks
|
|
101
|
+
- **Vitest**: `4.0.18`
|
|
102
|
+
|
|
103
|
+
#### Linting & Formatting
|
|
104
|
+
- **ESLint**: `9.39.2`
|
|
105
|
+
|
|
106
|
+
#### Type Definitions
|
|
107
|
+
- **@types/node**: `25.0.10`
|
|
108
|
+
- **@types/fs-extra**: `11.0.4`
|
|
109
|
+
|
|
110
|
+
### Project Structure & Conventions
|
|
111
|
+
- **Package Manager**: `pnpm` is the required package manager.
|
|
112
|
+
|
|
113
|
+
## Testing
|
|
114
|
+
|
|
115
|
+
### Approach
|
|
116
|
+
|
|
117
|
+
Tests are written using **Vitest** and follow **BDD (Behaviour-Driven Development)** conventions:
|
package/README.md
CHANGED
|
@@ -1,2 +1,47 @@
|
|
|
1
1
|
# ai-team
|
|
2
|
-
|
|
2
|
+
|
|
3
|
+
Repository with AI tooling for teams — Gemini CLI extensions and Claude Code marketplace plugins.
|
|
4
|
+
|
|
5
|
+
## Gemini CLI
|
|
6
|
+
|
|
7
|
+
### Installation
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
gemini extensions install https://github.com/dezkareid/ai-team
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Claude Code
|
|
14
|
+
|
|
15
|
+
### Install the marketplace
|
|
16
|
+
|
|
17
|
+
Add this marketplace to Claude Code so it can discover the available plugins:
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
claude marketplace add https://github.com/dezkareid/ai-team
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
### Available plugins
|
|
24
|
+
|
|
25
|
+
#### `npm-tools` — Tools for working with npm
|
|
26
|
+
|
|
27
|
+
| Command | Description |
|
|
28
|
+
|---|---|
|
|
29
|
+
| `npm-package-setup` | Initialize and publish a new npm package. |
|
|
30
|
+
| `npm-publish` | Setup NPM publication workflow with OIDC and provenance using local standard actions (Monorepo & pnpm support). |
|
|
31
|
+
|
|
32
|
+
### Install a plugin
|
|
33
|
+
|
|
34
|
+
Once the marketplace is added, install a plugin with:
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
claude plugin install npm-tools
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
### Use a command
|
|
41
|
+
|
|
42
|
+
Invoke any installed command directly from Claude Code:
|
|
43
|
+
|
|
44
|
+
```
|
|
45
|
+
/npm-package-setup my-lib 0.1.0 "A utility library"
|
|
46
|
+
/npm-publish
|
|
47
|
+
```
|
package/gemini-extension.json
CHANGED
package/package.json
CHANGED
|
@@ -1,30 +1,49 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@dezkareid/ai-team",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "1.1.0",
|
|
4
4
|
"description": "Repository for AI Team",
|
|
5
|
+
"type": "module",
|
|
5
6
|
"main": "index.js",
|
|
6
|
-
"scripts": {
|
|
7
|
-
"sync-version": "node scripts/sync-version.js",
|
|
8
|
-
"test": "echo \"Error: no test specified\" && exit 1"
|
|
9
|
-
},
|
|
10
7
|
"keywords": [],
|
|
11
8
|
"files": [
|
|
12
9
|
"README.md",
|
|
10
|
+
"AGENTS.md",
|
|
13
11
|
"gemini-extension.json"
|
|
14
12
|
],
|
|
15
13
|
"publishConfig": {
|
|
16
14
|
"access": "public",
|
|
17
|
-
"provenance":
|
|
15
|
+
"provenance": true
|
|
18
16
|
},
|
|
19
17
|
"repository": {
|
|
20
18
|
"type": "git",
|
|
21
19
|
"url": "git+https://github.com/dezkareid/ai-team.git"
|
|
22
20
|
},
|
|
23
21
|
"author": "Joel Humberto Gomez Paredes <elmaildeldezkareid@gmail.com>",
|
|
24
|
-
"license": "
|
|
22
|
+
"license": "MIT",
|
|
25
23
|
"bugs": {
|
|
26
24
|
"url": "https://github.com/dezkareid/ai-team/issues"
|
|
27
25
|
},
|
|
28
26
|
"homepage": "https://github.com/dezkareid/ai-team#readme",
|
|
29
|
-
"
|
|
27
|
+
"devDependencies": {
|
|
28
|
+
"@rollup/plugin-commonjs": "29.0.0",
|
|
29
|
+
"@rollup/plugin-node-resolve": "16.0.3",
|
|
30
|
+
"@rollup/plugin-typescript": "12.3.0",
|
|
31
|
+
"@types/fs-extra": "11.0.4",
|
|
32
|
+
"@types/node": "25.0.10",
|
|
33
|
+
"rollup": "4.56.0",
|
|
34
|
+
"tslib": "2.8.1",
|
|
35
|
+
"typescript": "5.9.3",
|
|
36
|
+
"vitest": "4.0.18"
|
|
37
|
+
},
|
|
38
|
+
"dependencies": {
|
|
39
|
+
"@iarna/toml": "2.2.5",
|
|
40
|
+
"fs-extra": "11.3.3",
|
|
41
|
+
"yaml": "2.8.2"
|
|
42
|
+
},
|
|
43
|
+
"scripts": {
|
|
44
|
+
"sync-version": "node dist/scripts/sync-version.js",
|
|
45
|
+
"build": "rollup -c",
|
|
46
|
+
"test": "vitest run",
|
|
47
|
+
"export-claude": "node dist/cli/export-claude.js"
|
|
48
|
+
}
|
|
30
49
|
}
|