aiwg
Version:
Cognitive architecture for AI-augmented software development with structured memory, ensemble validation, and closed-loop correction. FAIR-aligned artifacts, 84% cost reduction via human-in-the-loop, standards adopted by 100+ organizations.
260 lines (192 loc) • 7.51 kB
Markdown
# Academic Citations Guide
Reference citations for AIWG frameworks, providing theoretical foundations.
## Issues
- #216 (Voice/Style Transfer)
- #217 (Dual-Track Delivery)
- #218 (Semantic Service Discovery)
## 1. Voice Profile Framework
### Academic Foundation
The voice profile framework applies principles from controllable text generation research:
- **CTRL** (Keskar et al., 2019): Conditional transformer approach for style control
- **PPLM** (Dathathri et al., 2020): Attribute-based text generation without retraining
### Key Concepts
| Concept | CTRL/PPLM Term | AIWG Implementation |
|---------|----------------|---------------------|
| Voice profiles | Control codes | `voices/templates/*.yaml` |
| Style attributes | Bag-of-words | `tone`, `vocabulary`, `structure` |
| Temperature | Sampling parameter | Voice-specific defaults |
| Top-p/Top-k | Nucleus sampling | Output diversity control |
### References
```bibtex
@article{keskar2019ctrl,
title={CTRL: A Conditional Transformer Language Model for Controllable Generation},
author={Keskar, Nitish Shirish and McCann, Bryan and Varshney, Lav R and Xiong, Caiming and Socher, Richard},
journal={arXiv preprint arXiv:1909.05858},
year={2019}
}
@inproceedings{dathathri2020plug,
title={Plug and Play Language Models: A Simple Approach to Controlled Text Generation},
author={Dathathri, Sumanth and Madotto, Andrea and Lan, Janice and Hung, Jane and Frank, Eric and Molino, Piero and Yosinski, Jason and Liu, Rosanne},
booktitle={International Conference on Learning Representations},
year={2020}
}
```
### Application to Voice Profiles
**CTRL-Inspired Patterns**:
- Control codes map to voice profile selectors
- Domain-specific training → domain-specific vocabulary lists
- Style tokens → `tone` attributes in profiles
**PPLM-Inspired Patterns**:
- Attribute classifiers → validation rules in `writing-validator`
- Gradient-based steering → confidence thresholds for style matching
- No retraining required → declarative profile definitions
## 2. SDLC Framework
### Methodology Foundation
AIWG's SDLC framework synthesizes established methodologies:
- **SAFe 6.0** (Scaled Agile, 2023): Dual-track agile delivery
- **RUP** (Kruchten, 2003): Phase-based lifecycle with iteration
### Phase Mapping
| AIWG Phase | RUP Phase | SAFe Equivalent |
|------------|-----------|-----------------|
| Concept | Inception | PI Planning (Vision) |
| Inception | Inception | PI Planning (Roadmap) |
| Elaboration | Elaboration | Architecture Enablers |
| Construction | Construction | Feature Development |
| Transition | Transition | Release Train |
### Dual-Track Model
From SAFe 6.0:
```
Discovery Track Delivery Track
─────────────── ──────────────
├── Requirements ├── Implementation
├── Architecture ├── Testing
├── Design ├── Integration
└── Validation └── Deployment
```
**AIWG Implementation**:
- `/flow-discovery-track` orchestrates discovery
- `/flow-delivery-track` orchestrates delivery
- `/flow-iteration-dual-track` synchronizes both
### References
```bibtex
@book{kruchten2003rup,
title={The Rational Unified Process: An Introduction},
author={Kruchten, Philippe},
edition={3rd},
publisher={Addison-Wesley Professional},
year={2003}
}
@misc{scaledagile2023,
title={SAFe 6.0 Framework},
author={{Scaled Agile, Inc.}},
howpublished={\url{https://scaledagileframework.com/}},
year={2023}
}
```
### Application to SDLC
**RUP-Inspired Patterns**:
- Milestones at phase boundaries → gate checks
- Architecture-centric approach → Elaboration focus
- Iterative development → Ralph loops
- Risk-driven planning → Risk register integration
**SAFe-Inspired Patterns**:
- Program Increments → Iteration planning
- Enabler work → Infrastructure/architecture tasks
- Continuous delivery → `/flow-deploy-to-production`
- DevOps integration → DevOps Engineer agent
## 3. Extension System
### Semantic Discovery Foundation
AIWG's capability-based extension discovery applies SOA principles:
- **Semantic Matching** (Papazoglou & van den Heuvel, 2007): Capability-based service selection
- **Dynamic Composition** (Dustdar & Schreiner, 2005): Runtime orchestration
### Concept Mapping
| SOA Concept | AIWG Extension System |
|-------------|----------------------|
| Service | Extension (agent, command, skill) |
| Service Contract | Extension manifest |
| Service Registry | Extension registry |
| Service Discovery | Capability-based search |
| Service Composition | Multi-agent orchestration |
| Service Broker | Registry.ts |
### Semantic Search Model
```
Query: "I need to generate tests"
Extension Registry Search:
1. Parse natural language query
2. Extract capability keywords: ["test", "generate", "quality"]
3. Match against extension capabilities
4. Rank by relevance score
5. Return: test-engineer, test-architect, mutation-analyst
SOA Equivalent:
1. Service request arrives
2. Extract functional requirements
3. Query UDDI/registry
4. Select by QoS criteria
5. Return service endpoint
```
### References
```bibtex
@article{papazoglou2007soa,
title={Service-Oriented Architectures: Approaches, Technologies and Research Issues},
author={Papazoglou, Michael P and van den Heuvel, Willem-Jan},
journal={The VLDB Journal},
volume={16},
number={3},
pages={389--415},
year={2007},
publisher={Springer}
}
@article{dustdar2005survey,
title={A Survey on Web Services Composition},
author={Dustdar, Schahram and Schreiner, Wolfgang},
journal={International Journal of Web and Grid Services},
volume={1},
number={1},
pages={1--30},
year={2005}
}
```
### Application to Extensions
**SOA-Inspired Patterns**:
- Loose coupling → Extension independence
- Contract-first design → Manifest-driven definitions
- Late binding → Runtime agent selection
- Service versioning → Extension version constraints
- Choreography → Multi-agent workflows
## Integration Points
### Voice Framework
Update locations:
- `agentic/code/addons/voice-framework/README.md` - Academic Foundation section
- `agentic/code/addons/voice-framework/docs/voice-theory.md` - Detailed theory
- Voice profile templates - Reference academic principles
### SDLC Framework
Update locations:
- `agentic/code/frameworks/sdlc-complete/README.md` - Methodology Foundation
- `agentic/code/frameworks/sdlc-complete/docs/sdlc-theory.md` - Theory document
- Phase documentation - Cross-reference to SAFe/RUP
### Extension System
Update locations:
- `docs/extensions/overview.md` - Semantic Discovery section
- `src/extensions/registry.ts` - Citation comments
- `docs/research/soa-patterns.md` - Detailed SOA mapping
## Citation Format
Use APA 7th edition for consistency:
**Journal Article**:
> Author, A. A., & Author, B. B. (Year). Title of article. *Journal Name*, *volume*(issue), pages. https://doi.org/xxx
**Book**:
> Author, A. A. (Year). *Title of work: Capital letter also for subtitle*. Publisher.
**Conference Paper**:
> Author, A. A. (Year). Title of paper. In *Proceedings of Conference Name* (pp. xx-xx). Publisher.
**Website**:
> Author/Organization. (Year). *Title*. URL
## References
- @agentic/code/addons/voice-framework/README.md
- @agentic/code/frameworks/sdlc-complete/README.md
- @docs/extensions/overview.md
- @.aiwg/research/findings/