@nockdev/awf 6.2.0

package/.agent/core/CODING_STYLES.yaml

@@ -0,0 +1,346 @@
+# DOMYH Awesome Code — Language Coding Styles v6.2.0
+# ⚠️ DEPRECATED: This file is kept for reference only
+#
+# SSoT (Single Source of Truth) for language patterns:
+#   1. /code workflow (workflows/code.md) - Line 94-400
+#   2. coding-rules skill (skills/coding-rules/data/)
+#
+# This file contains 6 languages. For 30+ languages, see:
+#   - workflows/code.md → LANGUAGE REGISTRY section
+#   - skills/coding-rules/data/naming-conventions.csv
+#
+# Token-optimized: Load only active language
+
+# =============================================================================
+# 🔧 GO
+# =============================================================================
+
+go:
+  philosophy: "Simple is better than clever"
+
+  naming:
+    packages: "lowercase, short" # user, http
+    public: "PascalCase" # UserService
+    private: "camelCase" # userRepo
+    interfaces: "verb-er" # Reader, Writer
+    constants: "PascalCase" # MaxRetries
+
+  patterns:
+    error_handling: |
+      if err != nil {
+          return fmt.Errorf("context: %w", err)
+      }
+
+    dependency_injection: |
+      func NewService(repo Repository) *Service {
+          return &Service{repo: repo}
+      }
+
+    context_propagation: |
+      func DoWork(ctx context.Context) error {
+          select {
+          case <-ctx.Done():
+              return ctx.Err()
+          default:
+              // work
+          }
+      }
+
+    interface_definition: |
+      type Repository interface {
+          FindByID(ctx context.Context, id string) (*Entity, error)
+      }
+
+  anti_patterns:
+    - "Don't panic in libraries"
+    - "Don't use naked returns"
+    - "Don't ignore errors"
+    - "Don't use init() excessively"
+
+  project_structure: |
+    cmd/          # Entry points
+    internal/     # Private code
+    pkg/          # Public libraries
+    api/          # API definitions
+
+# =============================================================================
+# 🐍 PYTHON
+# =============================================================================
+
+python:
+  philosophy: "Readability counts"
+
+  naming:
+    modules: "snake_case" # user_service.py
+    classes: "PascalCase" # UserService
+    functions: "snake_case" # get_user_by_id
+    constants: "UPPER_SNAKE" # MAX_RETRIES
+    private: "_prefix" # _internal_func
+
+  patterns:
+    type_hints: |
+      def get_user(user_id: int) -> User | None:
+          pass
+
+    context_manager: |
+      with open("file.txt") as f:
+          content = f.read()
+
+    async_await: |
+      async def fetch_data(url: str) -> dict:
+          async with aiohttp.ClientSession() as session:
+              async with session.get(url) as response:
+                  return await response.json()
+
+    dataclass: |
+      @dataclass
+      class User:
+          id: int
+          name: str
+          email: str | None = None
+
+  anti_patterns:
+    - "Don't use mutable default args"
+    - "Don't catch bare exceptions"
+    - "Don't use wildcard imports"
+    - "Don't ignore type hints"
+
+  project_structure: |
+    src/
+      domain/       # Business logic
+      application/  # Use cases
+      infrastructure/  # External
+    tests/
+    pyproject.toml
+
+# =============================================================================
+# 📘 TYPESCRIPT
+# =============================================================================
+
+typescript:
+  philosophy: "Type safety enables refactoring"
+
+  naming:
+    files: "kebab-case" # user-service.ts
+    classes: "PascalCase" # UserService
+    interfaces: "PascalCase" # IUserRepository
+    functions: "camelCase" # getUserById
+    constants: "UPPER_SNAKE" # MAX_RETRIES
+    types: "PascalCase" # UserResponse
+
+  patterns:
+    type_guards: |
+      function isUser(value: unknown): value is User {
+        return typeof value === 'object' && value !== null && 'id' in value;
+      }
+
+    result_pattern: |
+      type Result<T, E = Error> = 
+        | { ok: true; value: T }
+        | { ok: false; error: E };
+
+    zod_validation: |
+      const UserSchema = z.object({
+        id: z.string().uuid(),
+        email: z.string().email(),
+      });
+      type User = z.infer<typeof UserSchema>;
+
+    react_component: |
+      interface Props {
+        user: User;
+        onUpdate: (user: User) => void;
+      }
+
+      export function UserCard({ user, onUpdate }: Props) {
+        return <div>{user.name}</div>;
+      }
+
+  anti_patterns:
+    - "Don't use 'any'"
+    - "Don't skip null checks"
+    - "Don't mutate state directly"
+    - "Don't export default"
+
+  project_structure: |
+    src/
+      components/   # UI
+      hooks/        # Custom hooks
+      lib/          # Utilities
+      types/        # Type definitions
+      app/          # Next.js routes
+
+# =============================================================================
+# 🦀 RUST
+# =============================================================================
+
+rust:
+  philosophy: "Memory safety without GC"
+
+  naming:
+    modules: "snake_case" # user_service.rs
+    structs: "PascalCase" # UserService
+    functions: "snake_case" # get_user_by_id
+    constants: "UPPER_SNAKE" # MAX_RETRIES
+    lifetimes: "lowercase short" # 'a, 'b
+
+  patterns:
+    error_handling: |
+      fn parse_config(path: &str) -> Result<Config, ConfigError> {
+          let content = fs::read_to_string(path)?;
+          let config: Config = serde_json::from_str(&content)?;
+          Ok(config)
+      }
+
+    builder_pattern: |
+      impl UserBuilder {
+          pub fn name(mut self, name: String) -> Self {
+              self.name = Some(name);
+              self
+          }
+          pub fn build(self) -> Result<User, Error> { ... }
+      }
+
+    option_handling: |
+      let name = user.name.as_ref().map(|n| n.to_uppercase());
+      // or
+      let name = user.name.unwrap_or_default();
+
+    async_function: |
+      async fn fetch_user(id: &str) -> Result<User> {
+          let response = reqwest::get(url).await?;
+          let user = response.json::<User>().await?;
+          Ok(user)
+      }
+
+  anti_patterns:
+    - "Don't use unwrap in library code"
+    - "Don't clone excessively"
+    - "Don't fight the borrow checker"
+    - "Don't use unsafe without reason"
+
+  project_structure: |
+    src/
+      lib.rs        # Library root
+      main.rs       # Binary entry
+      domain/       # Business logic
+      api/          # HTTP handlers
+    Cargo.toml
+
+# =============================================================================
+# ☕ JAVA
+# =============================================================================
+
+java:
+  philosophy: "OOP with strong typing"
+
+  naming:
+    packages: "lowercase.reversed" # com.example.user
+    classes: "PascalCase" # UserService
+    methods: "camelCase" # getUserById
+    constants: "UPPER_SNAKE" # MAX_RETRIES
+    interfaces: "PascalCase" # UserRepository
+
+  patterns:
+    record: |
+      public record User(Long id, String name, String email) {}
+
+    stream_api: |
+      List<String> names = users.stream()
+          .filter(u -> u.getAge() > 18)
+          .map(User::getName)
+          .collect(Collectors.toList());
+
+    optional: |
+      Optional<User> user = repository.findById(id);
+      return user.map(User::getName).orElse("Unknown");
+
+    spring_service: |
+      @Service
+      public class UserService {
+          private final UserRepository repository;
+          
+          public UserService(UserRepository repository) {
+              this.repository = repository;
+          }
+      }
+
+  anti_patterns:
+    - "Don't use null when Optional fits"
+    - "Don't ignore checked exceptions"
+    - "Don't use raw types"
+    - "Don't over-engineer"
+
+  project_structure: |
+    src/main/java/
+      com/example/
+        domain/       # Entities
+        repository/   # Data access
+        service/      # Business logic
+        controller/   # HTTP
+
+# =============================================================================
+# 🍎 SWIFT
+# =============================================================================
+
+swift:
+  philosophy: "Protocol-oriented programming"
+
+  naming:
+    types: "PascalCase" # UserService
+    methods: "camelCase" # getUserById
+    properties: "camelCase" # userName
+    protocols: "PascalCase" # Fetchable
+
+  patterns:
+    async_await: |
+      func fetchUser(id: String) async throws -> User {
+          let (data, _) = try await URLSession.shared.data(from: url)
+          return try JSONDecoder().decode(User.self, from: data)
+      }
+
+    result_type: |
+      func parse(_ json: Data) -> Result<User, ParseError> {
+          do {
+              let user = try JSONDecoder().decode(User.self, from: json)
+              return .success(user)
+          } catch {
+              return .failure(.invalidJSON)
+          }
+      }
+
+    property_wrapper: |
+      @State private var isLoading = false
+      @Binding var user: User
+      @EnvironmentObject var store: AppStore
+
+    swiftui_view: |
+      struct UserCard: View {
+          let user: User
+          
+          var body: some View {
+              VStack {
+                  Text(user.name)
+              }
+          }
+      }
+
+  anti_patterns:
+    - "Don't force unwrap in production"
+    - "Don't ignore optionals"
+    - "Don't use class when struct works"
+    - "Don't block main thread"
+
+# =============================================================================
+# 🎯 SELECTION LOGIC
+# =============================================================================
+
+usage:
+  load_on_detect:
+    - "Language detected from file patterns"
+    - "Language explicitly mentioned"
+
+  apply_patterns:
+    - "Code generation follows idioms"
+    - "Reviews check against anti-patterns"
+    - "Suggestions use project structure"

package/.agent/core/COMMANDS.md

@@ -0,0 +1,93 @@
+# DOMYH Awesome Code — Command Registry
+
+> 28 active slash commands • 3-Layer Skill Resolution
+
+---
+
+## Core Commands (9)
+
+| Command     | Description              | Skills Required   | Skills Contextual       |
+| ----------- | ------------------------ | ----------------- | ----------------------- |
+| `/init`     | ✨ Initialize project    | —                 | [auto]                  |
+| `/code`     | 💻 Write & fix code      | —                 | [auto]                  |
+| `/debug`    | 🐛 Systematic debugging  | —                 | [auto]                  |
+| `/plan`     | 📋 Feature planning      | —                 | —                       |
+| `/test`     | ✅ Run and write tests   | testing           | [auto]                  |
+| `/deploy`   | 🚀 Deploy to production  | ci-cd             | docker, kubernetes, aws |
+| `/refactor` | 🔧 Refactor & cleanup    | —                 | [auto]                  |
+| `/review`   | 👀 Code review           | security          | [auto]                  |
+| `/ap`       | 🔬 Full audit (5-expert) | security, testing | [auto]                  |
+
+## Git & Fix Commands (3)
+
+| Command   | Description           | Skills Required | Skills Contextual |
+| --------- | --------------------- | --------------- | ----------------- |
+| `/git`    | 🔀 Git operations hub | —               | —                 |
+| `/fix`    | ⚡ Quick-fix pipeline | —               | [auto]            |
+| `/revert` | ⏪ Rollback changes   | —               | ci-cd             |
+
+## Generation Commands (3)
+
+| Command     | Description               | Skills Required | Skills Contextual |
+| ----------- | ------------------------- | --------------- | ----------------- |
+| `/generate` | ⚡ Code generation        | —               | [auto]            |
+| `/scaffold` | 🏗️ Generate from patterns | —               | [auto]            |
+| `/doc`      | 📚 Documentation          | —               | [auto]            |
+
+## Planning & Design (3)
+
+| Command      | Description            | Skills Required | Skills Contextual |
+| ------------ | ---------------------- | --------------- | ----------------- |
+| `/think`     | 💡 Brainstorming Pro   | —               | —                 |
+| `/visualize` | 🖼️ UI/UX mockups       | ui-ux-pro-max   | —                 |
+| `/perf`      | 📈 Performance profile | —               | [auto]            |
+
+## DevOps Commands (5)
+
+| Command    | Description               | Skills Required       | Skills Contextual |
+| ---------- | ------------------------- | --------------------- | ----------------- |
+| `/migrate` | 🗄️ Database migrations    | database              | [auto]            |
+| `/monitor` | 📊 Observability setup    | observability,logging | —                 |
+| `/env`     | 🔐 Environment management | —                     | —                 |
+| `/upgrade` | ⬆️ Dependency updates     | —                     | [auto]            |
+| `/dev`     | ▶️ Start dev server       | —                     | [auto]            |
+
+## Utility Commands (5)
+
+| Command        | Description                      | Skills |
+| -------------- | -------------------------------- | ------ |
+| `/recap`       | 📖 Session summary               | —      |
+| `/status`      | 📊 Project status                | —      |
+| `/help`        | ❓ Help                          | —      |
+| `/workflow`    | 🔄 Workflow discovery & chaining | —      |
+| `/orchestrate` | 🎭 Multi-agent coordination      | —      |
+
+---
+
+## Skill Resolution Flow
+
+```
+User: /command [args]
+    │
+    ▼
+┌─────────────────────────────────┐
+│ L1: Deterministic (0ms)         │
+│ → Load skills.required from     │
+│   manifest/frontmatter          │
+├─────────────────────────────────┤
+│ L2: Contextual (<50ms)          │
+│ → Detect from project files     │
+│ → [auto] = file pattern match   │
+├─────────────────────────────────┤
+│ L3: Semantic (<200ms)           │
+│ → Match user query keywords     │
+│ → to skill META.yaml keywords   │
+└─────────────────────────────────┘
+    │
+    ▼
+  Skill Set (max 5)
+```
+
+---
+
+_DOMYH Awesome Code • 3-Layer Skill Resolution_