Merge branch 'feat/wobble-core-implementation' into dev

Author: LittleCoinCoin

CONTRIBUTING.md

@@ -1,29 +1,38 @@
-# {{PROJECT_NAME}}
+# Wobble
 
-{{PROJECT_DESCRIPTION}}
+Centralized testing package for Cracking Shells
 
 ## Installation
 
 ### From Source
 
 ```bash
-git clone https://github.com/CrackingShells/{{PROJECT_NAME}}.git
-cd {{PROJECT_NAME}}
+git clone https://github.com/CrackingShells/Wobble.git
+cd Wobble
 pip install -e .
 ```
 
 ### From PyPI (when available)
 
 ```bash
-pip install {{PROJECT_NAME}}
+pip install wobble
 ```
 
 ## Quick Start
 
-```python
-import {{PACKAGE_NAME}}
+```bash
+# Install wobble
+pip install -e .
+
+# Run all tests
+wobble
 
-# Add basic usage example here
+# Run specific test categories
+wobble --category regression
+wobble --category integration
+
+# Get help
+wobble --help
 ```
 
 ## Development
@@ -32,8 +41,8 @@ import {{PACKAGE_NAME}}
 
 ```bash
 # Clone the repository
-git clone https://github.com/CrackingShells/{{PROJECT_NAME}}.git
-cd {{PROJECT_NAME}}
+git clone https://github.com/CrackingShells/Wobble.git
+cd Wobble
 
 # Install in development mode
 pip install -e .
@@ -45,11 +54,17 @@ npm install
 ### Running Tests
 
 ```bash
-# Run all tests
-python -m unittest discover tests
+# Run all tests with wobble
+wobble
 
-# Run specific test file
-python -m unittest tests.test_basic
+# Run tests by category
+wobble --category regression
+
+# Run with verbose output
+wobble --verbose
+
+# Alternative: use unittest directly
+python -m unittest discover tests
 ```
 
 ### Making Commits
@@ -66,9 +81,20 @@ git commit -m "fix: resolve issue with X"
 git commit -m "docs: update README"
 ```
 
+## Documentation
+
+Complete documentation is available in the [docs/articles/](docs/articles/) directory:
+
+- **[Getting Started](docs/articles/users/GettingStarted.md)** - Installation and basic usage
+- **[CLI Reference](docs/articles/users/CLIReference.md)** - Complete command reference
+- **[Test Organization](docs/articles/users/TestOrganization.md)** - Test categorization strategies
+- **[Integration Guide](docs/articles/users/IntegrationGuide.md)** - Repository integration
+- **[Architecture Overview](docs/articles/devs/architecture/Overview.md)** - System design
+- **[Contributing Guidelines](docs/articles/devs/contribution_guidelines/Contributing.md)** - Development workflow
+
 ## Contributing
 
-We welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) for details on:
+We welcome contributions! Please see our [Contributing Guide](docs/articles/devs/contribution_guidelines/Contributing.md) for details on:
 
 - Development workflow
 - Code style guidelines
@@ -81,6 +107,6 @@ This project is licensed under the GNU Affero General Public License v3 - see th
 
 ## Links
 
-- **Homepage**: https://github.com/CrackingShells/{{PROJECT_NAME}}
-- **Bug Reports**: https://github.com/CrackingShells/{{PROJECT_NAME}}/issues
-- **Documentation**: [Coming Soon]
+- **Homepage**: https://github.com/CrackingShells/Wobble
+- **Bug Reports**: https://github.com/CrackingShells/Wobble/issues
+- **Documentation**: [docs/articles/](docs/articles/)