@adriankulik/create-fullstack-app 1.1.0 → 1.2.0

package/templates/base/.agents/skills/senior-qa/scripts/e2e_test_scaffolder.py

@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+"""
+E2E Test Scaffolder
+Automated tool for senior qa tasks
+"""
+
+import os
+import sys
+import json
+import argparse
+from pathlib import Path
+from typing import Dict, List, Optional
+
+class E2ETestScaffolder:
+    """Main class for e2e test scaffolder functionality"""
+    
+    def __init__(self, target_path: str, verbose: bool = False):
+        self.target_path = Path(target_path)
+        self.verbose = verbose
+        self.results = {}
+    
+    def run(self) -> Dict:
+        """Execute the main functionality"""
+        print(f"🚀 Running {self.__class__.__name__}...")
+        print(f"📁 Target: {self.target_path}")
+        
+        try:
+            self.validate_target()
+            self.analyze()
+            self.generate_report()
+            
+            print("✅ Completed successfully!")
+            return self.results
+            
+        except Exception as e:
+            print(f"❌ Error: {e}")
+            sys.exit(1)
+    
+    def validate_target(self):
+        """Validate the target path exists and is accessible"""
+        if not self.target_path.exists():
+            raise ValueError(f"Target path does not exist: {self.target_path}")
+        
+        if self.verbose:
+            print(f"✓ Target validated: {self.target_path}")
+    
+    def analyze(self):
+        """Perform the main analysis or operation"""
+        if self.verbose:
+            print("📊 Analyzing...")
+        
+        # Main logic here
+        self.results['status'] = 'success'
+        self.results['target'] = str(self.target_path)
+        self.results['findings'] = []
+        
+        # Add analysis results
+        if self.verbose:
+            print(f"✓ Analysis complete: {len(self.results.get('findings', []))} findings")
+    
+    def generate_report(self):
+        """Generate and display the report"""
+        print("\n" + "="*50)
+        print("REPORT")
+        print("="*50)
+        print(f"Target: {self.results.get('target')}")
+        print(f"Status: {self.results.get('status')}")
+        print(f"Findings: {len(self.results.get('findings', []))}")
+        print("="*50 + "\n")
+
+def main():
+    """Main entry point"""
+    parser = argparse.ArgumentParser(
+        description="E2E Test Scaffolder"
+    )
+    parser.add_argument(
+        'target',
+        help='Target path to analyze or process'
+    )
+    parser.add_argument(
+        '--verbose', '-v',
+        action='store_true',
+        help='Enable verbose output'
+    )
+    parser.add_argument(
+        '--json',
+        action='store_true',
+        help='Output results as JSON'
+    )
+    parser.add_argument(
+        '--output', '-o',
+        help='Output file path'
+    )
+    
+    args = parser.parse_args()
+    
+    tool = E2ETestScaffolder(
+        args.target,
+        verbose=args.verbose
+    )
+    
+    results = tool.run()
+    
+    if args.json:
+        output = json.dumps(results, indent=2)
+        if args.output:
+            with open(args.output, 'w') as f:
+                f.write(output)
+            print(f"Results written to {args.output}")
+        else:
+            print(output)
+
+if __name__ == '__main__':
+    main()

package/templates/base/.agents/skills/senior-qa/scripts/test_suite_generator.py

@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+"""
+Test Suite Generator
+Automated tool for senior qa tasks
+"""
+
+import os
+import sys
+import json
+import argparse
+from pathlib import Path
+from typing import Dict, List, Optional
+
+class TestSuiteGenerator:
+    """Main class for test suite generator functionality"""
+    
+    def __init__(self, target_path: str, verbose: bool = False):
+        self.target_path = Path(target_path)
+        self.verbose = verbose
+        self.results = {}
+    
+    def run(self) -> Dict:
+        """Execute the main functionality"""
+        print(f"🚀 Running {self.__class__.__name__}...")
+        print(f"📁 Target: {self.target_path}")
+        
+        try:
+            self.validate_target()
+            self.analyze()
+            self.generate_report()
+            
+            print("✅ Completed successfully!")
+            return self.results
+            
+        except Exception as e:
+            print(f"❌ Error: {e}")
+            sys.exit(1)
+    
+    def validate_target(self):
+        """Validate the target path exists and is accessible"""
+        if not self.target_path.exists():
+            raise ValueError(f"Target path does not exist: {self.target_path}")
+        
+        if self.verbose:
+            print(f"✓ Target validated: {self.target_path}")
+    
+    def analyze(self):
+        """Perform the main analysis or operation"""
+        if self.verbose:
+            print("📊 Analyzing...")
+        
+        # Main logic here
+        self.results['status'] = 'success'
+        self.results['target'] = str(self.target_path)
+        self.results['findings'] = []
+        
+        # Add analysis results
+        if self.verbose:
+            print(f"✓ Analysis complete: {len(self.results.get('findings', []))} findings")
+    
+    def generate_report(self):
+        """Generate and display the report"""
+        print("\n" + "="*50)
+        print("REPORT")
+        print("="*50)
+        print(f"Target: {self.results.get('target')}")
+        print(f"Status: {self.results.get('status')}")
+        print(f"Findings: {len(self.results.get('findings', []))}")
+        print("="*50 + "\n")
+
+def main():
+    """Main entry point"""
+    parser = argparse.ArgumentParser(
+        description="Test Suite Generator"
+    )
+    parser.add_argument(
+        'target',
+        help='Target path to analyze or process'
+    )
+    parser.add_argument(
+        '--verbose', '-v',
+        action='store_true',
+        help='Enable verbose output'
+    )
+    parser.add_argument(
+        '--json',
+        action='store_true',
+        help='Output results as JSON'
+    )
+    parser.add_argument(
+        '--output', '-o',
+        help='Output file path'
+    )
+    
+    args = parser.parse_args()
+    
+    tool = TestSuiteGenerator(
+        args.target,
+        verbose=args.verbose
+    )
+    
+    results = tool.run()
+    
+    if args.json:
+        output = json.dumps(results, indent=2)
+        if args.output:
+            with open(args.output, 'w') as f:
+                f.write(output)
+            print(f"Results written to {args.output}")
+        else:
+            print(output)
+
+if __name__ == '__main__':
+    main()

package/templates/base/ACCESSIBILITY.md

@@ -0,0 +1,117 @@
+# Accessibility Commitment (ACCESSIBILITY.md)
+
+## 1. Our commitment
+
+We believe accessibility is a subset of quality. This project commits to **WCAG 2.2 AA** standards for all documentation and example code. We track our progress publicly to remain accountable to our users.
+
+## 2. Real-time health metrics
+
+| Metric                       | Status / Value                                                                                      |
+| :--------------------------- | :-------------------------------------------------------------------------------------------------- |
+| **Open A11y Issues**         | [View open accessibility issues](https://github.com/mgifford/ACCESSIBILITY.md/labels/accessibility) |
+| **Automated Test Pass Rate** | Monitored via link checking and documentation validation                                            |
+| **A11y PRs Merged (MTD)**    | Tracked in [project insights](https://github.com/mgifford/ACCESSIBILITY.md/pulse)                   |
+| **Browser Support**          | Last 2 major versions of Chrome, Firefox, Safari - [View Policy](./BROWSER_SUPPORT.md)              |
+
+## 3. Contributor requirements (the guardrails)
+
+To contribute to this repo, you must follow these guidelines:
+
+- **Documentation Testing:** All documentation examples must follow accessibility best practices
+- **Code Examples:** Follow our component-specific best practices:
+  - [SVG Accessibility Best Practices](./examples/SVG_ACCESSIBILITY_BEST_PRACTICES.md)
+  - [Mermaid Diagram Best Practices](./examples/MERMAID_ACCESSIBILITY_BEST_PRACTICES.md)
+  - [Forms Accessibility Best Practices](./examples/FORMS_ACCESSIBILITY_BEST_PRACTICES.md)
+  - [Keyboard Accessibility Best Practices](./examples/KEYBOARD_ACCESSIBILITY_BEST_PRACTICES.md)
+  - [Light/Dark Mode Accessibility Best Practices](./examples/LIGHT_DARK_MODE_ACCESSIBILITY_BEST_PRACTICES.md)
+- **Link Validation:** All documentation links must pass our automated link checker
+- **Inclusive Language:** Use person-centered, respectful language throughout
+
+## 4. Reporting and severity taxonomy
+
+Please use our [issue templates](https://github.com/mgifford/ACCESSIBILITY.md/issues/new) when reporting issues. We prioritize based on:
+
+- **Critical:** Documentation error that could lead to implementing inaccessible features that prevent users from completing core tasks
+- **High:** Significant guidance gap or misleading information that could create accessibility barriers
+- **Medium:** Documentation clarity issues or incomplete examples
+- **Low:** Minor improvements, typos, or enhancements
+
+## 5. Automated check coverage
+
+We track our automated testing rules against the [Axe Rules Reference](./examples/AXE_RULES_REFERENCE.md).
+
+Our documentation includes:
+
+- Comprehensive axe-core rule mappings ([AXE_RULES_COVERAGE.md](./examples/AXE_RULES_COVERAGE.md))
+- Shift-left automation guidance ([SHIFT_LEFT_ACCESSIBILITY_AUTOMATION.md](./examples/SHIFT_LEFT_ACCESSIBILITY_AUTOMATION.md))
+- Pre-commit hook samples ([PRE_COMMIT_ACCESSIBILITY_SAMPLE.yaml](./examples/PRE_COMMIT_ACCESSIBILITY_SAMPLE.yaml))
+- CI/CD workflow examples ([A11Y_SHIFT_LEFT_WORKFLOW.yml](./examples/A11Y_SHIFT_LEFT_WORKFLOW.yml))
+
+## 6. Browser and assistive technology testing
+
+### Browser support guarantees
+
+This project supports the **last 2 major versions** of all major browser engines:
+
+- **Chrome/Chromium** (including Edge, Brave, Opera)
+- **Firefox**
+- **Safari/WebKit** (macOS and iOS)
+
+See our comprehensive [Browser Support Policy](./BROWSER_SUPPORT.md) for version details, testing requirements, and implementation guidance.
+
+### Assistive technology testing
+
+Contributors are encouraged to test documentation and examples with:
+
+- **Screen readers:** JAWS, NVDA, VoiceOver, TalkBack
+- **Keyboard navigation:** Tab, arrow keys, standard shortcuts
+- **Magnification tools:** Browser zoom, screen magnifiers
+- **Voice control:** Dragon, Voice Control
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for details on reporting assistive technology test results.
+
+## 7. Machine-readable standards
+
+This project leverages [wai-yaml-ld](https://github.com/mgifford/wai-yaml-ld) for machine-readable accessibility standards, enabling AI agents to provide standards-grounded guidance. All vetted sources are documented in [TRUSTED_SOURCES.yaml](./examples/TRUSTED_SOURCES.yaml).
+
+### Respecting content creator preferences
+
+While we maintain a list of trusted accessibility sources, we recognize and respect that not all content creators want their work scraped or used for AI training. Our [TRUSTED_SOURCES.yaml](./examples/TRUSTED_SOURCES.yaml) includes an `ai_scraping` field to indicate each source's preferences:
+
+- **`allowed`** (default): Content may be used for AI training and reference
+- **`prohibited`**: Do not scrape, crawl, or use content for AI training. Reference and cite only
+- **`restricted`**: Use only for reference and citation purposes, not for training data
+
+**For AI agents and automated tools:** Always check the `ai_scraping` field before accessing content from listed sources. Even trusted accessibility experts may prohibit AI scraping of their content. Respect these preferences by:
+
+- Not crawling or scraping sites marked as `prohibited`
+- Citing and linking to content instead of reproducing it
+- Using alternative sources when training data is needed
+
+**For human contributors:** When adding new sources to TRUSTED_SOURCES.yaml, check the website's robots.txt, terms of service, or public statements about AI scraping, and set the `ai_scraping` field accordingly.
+
+## 8. Known limitations
+
+As a documentation repository:
+
+- We provide guidance and templates but cannot test actual implementations
+- Examples are illustrative and may need adaptation for specific contexts
+- We rely on community feedback to identify gaps and outdated patterns
+
+## 9. Getting help
+
+- **Questions:** Open a [discussion](https://github.com/mgifford/ACCESSIBILITY.md/discussions)
+- **Bugs or gaps:** Open an [issue](https://github.com/mgifford/ACCESSIBILITY.md/issues)
+- **Contributions:** See [CONTRIBUTING.md](./CONTRIBUTING.md)
+- **Accommodations:** Request via `accessibility-accommodation` label
+
+## 10. Continuous improvement
+
+We regularly review and update:
+
+- WCAG conformance as standards evolve
+- Best practices based on community feedback
+- Tool recommendations and automation examples
+- Inclusive language and terminology
+
+Last updated: 2026-02-23

package/templates/base/{GEMINI.md → AGENTS.md}

@@ -1,4 +1,4 @@
-# GEMINI.md
+# AGENTS.md
 
 Behavioral guidelines to reduce common LLM coding mistakes. Merge with project-specific instructions as needed.
 

package/templates/base/README.md

@@ -35,3 +35,15 @@ To start both the frontend and backend development servers, simply run:
   ```bash
   ./lint.sh
   ```
+
+## AI Development Friendly
+
+This repository is optimized for development with AI agents:
+- **`AGENTS.md`**: Provides behavioral guidelines and critical instructions to constrain and guide the AI.
+- **`ACCESSIBILITY.md`**: Provides accessibility guidelines and constraints to guide the AI's implementations.
+- **`.agents/skills/`**: Includes an extensive set of agent skills sourced from [claude-skills](https://github.com/alirezarezvani/claude-skills).
+
+<details>
+<summary>Included Agent Skills</summary>
+<p>senior-frontend, senior-qa, senior-fullstack, accessibility-general</p>
+</details>