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
80 changes: 80 additions & 0 deletions .agents/skills/mizan/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
```markdown
# mizan Development Patterns

> Auto-generated skill from repository analysis

## Overview
This skill teaches the core development patterns and conventions used in the `mizan` Python codebase. You'll learn about file naming, import/export styles, commit message conventions, and how to write and run tests. This guide helps maintain consistency and efficiency when contributing to `mizan`.

## Coding Conventions

### File Naming
- Use **camelCase** for file names.
- Example: `myModule.py`, `dataProcessor.py`

### Import Style
- Use **relative imports** within the codebase.
- Example:
```python
from .utils import helperFunction
```

### Export Style
- Use **named exports** (explicitly define what is exported).
- Example:
```python
__all__ = ['mainFunction', 'helperFunction']
```

### Commit Messages
- Follow **conventional commit** patterns.
- Use prefixes such as `docs` for documentation and `feat` for new features.
- Example:
```
feat: add data normalization to processor
docs: update usage instructions in README
```

## Workflows

### Adding a New Feature
**Trigger:** When implementing new functionality.
**Command:** `/add-feature`

1. Create a new Python file using camelCase naming.
2. Implement the feature using relative imports as needed.
3. Export key functions or classes using `__all__`.
4. Write a test file named `featureName.test.py`.
5. Commit your changes with a `feat:` prefix.
- Example: `feat: implement user authentication`
6. Push your branch and open a pull request.

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

1. Edit or create documentation files as needed.
2. Commit changes with a `docs:` prefix.
- Example: `docs: add API usage examples`
3. Push your branch and open a pull request.

## Testing Patterns

- Test files follow the pattern `*.test.*` (e.g., `myModule.test.py`).
- The testing framework is **unknown**, so check existing test files for structure.
- Place tests alongside the modules they test or in a dedicated test directory.
- Example test file:
```python
# myModule.test.py
from .myModule import mainFunction

def test_mainFunction():
assert mainFunction(2, 2) == 4
```

## Commands
| Command | Purpose |
|-----------------|-----------------------------------------|
| /add-feature | Start the workflow for adding a feature |
| /update-docs | Start the workflow for documentation |
```
6 changes: 6 additions & 0 deletions .agents/skills/mizan/agents/openai.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
interface:
display_name: "Mizan"
short_description: "Repo-specific patterns and workflows for mizan"
default_prompt: "Use the mizan repo skill to follow existing architecture, testing, and workflow conventions."
policy:
allow_implicit_invocation: true
251 changes: 251 additions & 0 deletions .claude/ecc-tools.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,251 @@
{
"version": "1.3",
"schemaVersion": "1.0",
"generatedBy": "ecc-tools",
"generatedAt": "2026-06-01T17:04:27.738Z",
"repo": "https://github.com/CodeWithJuber/mizan",
"referenceSetReadiness": {
"score": 0,
"present": 0,
"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": "missing",
"evidence": [],
"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": "research",
"recommended": "research",
"effective": "developer",
"requestedAlias": "research",
"recommendedAlias": "research",
"effectiveAlias": "developer"
},
"requestedProfile": "research",
"profile": "developer",
"recommendedProfile": "research",
"effectiveProfile": "developer",
"tier": "free",
"requestedComponents": [
"repo-baseline",
"workflow-automation",
"research-tooling"
],
"selectedComponents": [
"repo-baseline",
"workflow-automation"
],
"requestedAddComponents": [],
"requestedRemoveComponents": [],
"blockedRemovalComponents": [],
"tierFilteredComponents": [
"research-tooling"
],
"requestedRootPackages": [
"runtime-core",
"workflow-pack",
"research-pack"
],
"selectedRootPackages": [
"runtime-core",
"workflow-pack"
],
"requestedPackages": [
"runtime-core",
"workflow-pack",
"research-pack"
],
"requestedAddPackages": [],
"requestedRemovePackages": [],
"selectedPackages": [
"runtime-core",
"workflow-pack"
],
"packages": [
"runtime-core",
"workflow-pack"
],
"blockedRemovalPackages": [],
"tierFilteredRootPackages": [
"research-pack"
],
"tierFilteredPackages": [
"research-pack"
],
"conflictingPackages": [],
"dependencyGraph": {
"runtime-core": [],
"workflow-pack": [
"runtime-core"
]
},
"resolutionOrder": [
"runtime-core",
"workflow-pack"
],
"requestedModules": [
"runtime-core",
"workflow-pack",
"research-pack"
],
"selectedModules": [
"runtime-core",
"workflow-pack"
],
"modules": [
"runtime-core",
"workflow-pack"
],
"managedFiles": [
".claude/skills/mizan/SKILL.md",
".agents/skills/mizan/SKILL.md",
".agents/skills/mizan/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/mizan-instincts.yaml"
],
"packageFiles": {
"runtime-core": [
".claude/skills/mizan/SKILL.md",
".agents/skills/mizan/SKILL.md",
".agents/skills/mizan/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/mizan-instincts.yaml"
]
},
"moduleFiles": {
"runtime-core": [
".claude/skills/mizan/SKILL.md",
".agents/skills/mizan/SKILL.md",
".agents/skills/mizan/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/mizan-instincts.yaml"
]
},
"files": [
{
"moduleId": "runtime-core",
"path": ".claude/skills/mizan/SKILL.md",
"description": "Repository-specific Claude Code skill generated from git history."
},
{
"moduleId": "runtime-core",
"path": ".agents/skills/mizan/SKILL.md",
"description": "Codex-facing copy of the generated repository skill."
},
{
"moduleId": "runtime-core",
"path": ".agents/skills/mizan/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/mizan-instincts.yaml",
"description": "Continuous-learning instincts derived from repository patterns."
}
],
"workflows": [],
"adapters": {
"claudeCode": {
"skillPath": ".claude/skills/mizan/SKILL.md",
"identityPath": ".claude/identity.json",
"commandPaths": []
},
"codex": {
"configPath": ".codex/config.toml",
"agentsGuidePath": ".codex/AGENTS.md",
"skillPath": ".agents/skills/mizan/SKILL.md"
}
}
}
Loading
Loading